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THE COPYRIGHT LAW ALLOWS THE CREATION OF ARCHIVAL COPIES OF COMPUTER 
SOFTWARE WHICH IS OWNED BY THE LOCKSMITH USER. LOCKSMITH IS SOLD WITH THE 
UNDERSTANDING THAT THE PURCHASER WILL NOT USE THE PROGRAM TO GENERATE 
DISKS OF COPYRIGHTED PROGRAMS FOR SALE OR DISTRIBUTION. 



^BOUT VOUFt MEW LOCKSMITH <£» - O 

Locksmith was first released in December, 1980. It was the first bit-copy 
(or nibble-copy) program available for the Apple. Since that time. 
Locksmith has evolved from a bit-copy program into a powerful disk ana 
memory utility. 

While other bit-copiers made minor enhancements and charged update fees 
for the "new" software. Locksmith users have been able to install 
enhancements to their own copies of Locksmith by applying patches which 
are supplied free of charge. 

As new enhancements to Locksmith become available in the form of updates, 
user applied patches, and new parameter disks, registered users are 
notified by mail or the Locksmith newsletter. If you have not already 
done so, be sure tti complete the registration card included with your 
Locksmith. 

Locksmith programming language (LPL) has been greatly '"'P''"^^^- Z'^';']: . 
users found the LPL section in the version 5.0 manual to be difficult to 
read A large part of this manual is dedicated to explaining the details 
of LPL, using many examples. While a great deal of effort has been made 
to keep LPL in version 6.0 compatible with LPL in version 5.0, the code 
itself has been completely rewritten, and language definitions have been 
extended to allow for easy future expansion. Almost all Locksmith 
functions can now be invoked from LPL (including Fast Disk Backup and 
sector editing). 



The Locksmith philosophy has always been to allow the "^^--t" backup his 
software, but not to promote software piracy in any way. Locksmith always 
made an identical copy of the original diskette, including 

copy-protection, copyright notices, and serial numbers. J^i^ "^"PV "^^^.^^^ 
locksmith was, like the original diskette, copy-protected. New protect on 
techniques were introduced and Locksmith handled them. However, recently 
some manufacturers have introduced copy protection techniques which are 
based on the fact that special hardware can create a special signature 
which can be read by a standard Apple disk drive, but not rewritten. 
Berause of the introduction of these truly uncopyable diskettes, we have 
found it necessary to allow the user to "unprotecf or " '''^"^ 
software in order to make a backup. It is important to ^^^^.^^ 
providing tools to allow the user to remove the copy protection, that we 
in no way condone or promote software piracy. Me will not knowingly 
accept or publish parameters which remove copyright notices, serial 
numbers, or other identifying information along with the copy protection. 
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l_Qcl,siiiith 6.0 has many completely new functions, includingi 

Automatic Boot Tracer 

Sector and Track Editor 

Sector Editor for Protected diskettes 

RAM Card Utilities including RAMtest. 

Advanced Disk Recovery i 
Data MTittan off-center 
Data written on misaligned driva 
Partially overMrittan sectors 

DOS File Utilities: 
Alphabetize CATALOG 
Un-Delete a file 
Remove DOS from diskette 
Fix sector counts 
Verify VTOC and fix errors 
Disk space map 
File Editor 

Encrypt /Decrypt a file 



BACKIIMIB CJF* YOUF* L-OCKSM I TM D I SK 

Your Locksmith 6.0 disk and the included parameter diskette {parmdisk> are 
not copy-protected. You should immediately make a backup copy of your 
original diskettes using tlie FAST DISK BACKUP function of the main nienu 
and place the originals in a safe place. Vou may need the original 
Locksmith diskette for program updates, as they are made available. 
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THE mSXOFlY aF=- L-OCJKSMITM 



For the past several years, there has been an intense battle being fought 
between software manufacturers and software users. The manufacturers, 
concerned about their programs being pirated or stolen, started 
'protecting' their software. They did this by making their programs 
uncopyable. This means that normal copy programs would no longer copy 
their softHare. Since it could not be copied, it could not be passed 
around between users. This was to insure that anyone Mho wished to use a 
program would be required to purchase it, thereby guaranteeing that the 
manufacturer would receive his fair share of profits. 

As in most issues, however, there are two sides. Software users, upon 
purchasing a program, received a disk which they could not copy. This 
mean-i that they could not even make back-ups of their disks, which is a 
legitimate concern of everyone who has 'blown' a disk. Since some 
businesses day to day operations rely very heavily on their software 
investment, this becomes a very critical situation. Some applications 
simply do not allow for up to several weeks waiting time while the bad 
disk IS sent out to be replaced. In addition, some of the manufacturers 
charge inflated prices to get these replacements. It seems rather unfair 
to charge S35.0O for a replacement Of a ^.OO disk for which the user 
already paid S250.00 to purchase. 

Shortly after these 'protected' disks started appearing on the market. 

Locksmith was made available to copy these disks. Locksmith used a new 
type of technology to copy protected software, known as nibble-copying. 
In the several years since, the manufacturers have introduced new, more 
sophisticated methods of copy protection. As a result. Locksmith has been 
updated several times to anticipate new methods of protection. 

In this section, we will discuss the origin of Locksmith, and some of the 
different methods that have been used for protection over the past several 
years. 

The original Locksmith program was written in 1979 by an Apple programiser 
with IB years of computer experience, including systems programming on 
large IBM mainframes at several large corporations. His interest in 
computers dates back to grammar school, when he would spend his Saturdays 
taking computer courses at the IIT computation center in Chicago. 

The first version of Locksmith, which was never released, was a primitive 
nibble copy program known as 'NIBV. It was written as an educational 
excercise ~ "because it was a challenge". When it was shown to some of 
his close friends from the local Apple users group, it gathered much 
interest, and because no program like it was available, several Apple 
users suggested that the program might be marketable. 

In December 19B0, Locksmith version 2.0 was released. It was the first 
program ever introduced to allow the Apple user to backup his 
copy-protected software. 

Like any tool in the wrong hands, it was feared that Locksmith might be 
used for tasts it was not intended to perform — PIRATING. Because of 
this fear, each Locksmith was uniquely serial mMbered and '"•«»»*?f»?' 
every copy of Locksmith also placed this unique Mriat number on EVERY 
disk that it copied. This fact, by the way, was never made kfiown until 
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Encoding the Locksmith serial number on the copied disk provided the 
distributor with the capability of identifying the owner of any Locksmith 
used for pirating any manufacturers software, and the distributor offered 
to assist software manufacturers in the prosecution of software pirates. 
No software manufacturer however, has ever requested this assistance. 
Placing the Locksmith serial number in an inconspicuous place on every 
disk that is copied is not an easy task. In fact, this practice has 
caused several problems with copying soma disks in early <version 4) 
releases of Locksmith. Because of this. Locksmith, beginning with version 
5.0 no longer encoded its serial number on the copy disk. 

Locksmith has evolved from version 1.0 (the unreleased 'NIBY'), to 
versions 2.0, 2.1, 2.2, 3.0, 3.1, 4.0, 4.1, 4.1a, 5.0, 5.1, and now 6.0. 
No longer the work of a single programmer. Locksmith 6.0 is noM maintained 
by a team of Apple copy-protection experts. 

No longer just a nibble-copier. Locksmith is now a f ul 1 -featured utility 
and diagnostic tool for the Apple II computer. Always searching for 
improvements. Alpha Logic welcomes suggestions, comments, and any 
questions you may have about Ldcksaith. 

Me will now discuss some of the different methods that have been used for 

protection over the past several years. Some of the descriptions are of a 
technical nature, and are intended for the more advanced user . 

The very first types of copy protection to appear were very simple in 
nature. The first protected disks used nothing more complicated than 
erasing an unused track on the disk. This was usually track 3. This 
method is not very complicated, but initially it was quite effective. All 
of the copy programs at that time copied the disk one track at a time. 
When It tried to read the erased track, it would get an I/O error, causing 
the copy program to stop. By doing this, none ttf th» tracks beyond tti» 
erased track would copy. 

Some of the copy programs that came out a little later would copy only 
those sectors that were marked on the catalog track (track »11) as being 
used. This got past the erased track problem. To combat those copy 
programs, companies started to move the catalog to a different track. 
Mhen the copy program went out to track *ll to read the information, the 
information would not be there. This also prevented a normal Disk 
Operating System (DOS) from reading and Mriting to the protected disk. 

Shortly after that time, a new method was introduced. It was a little 
known fact that while the disk normally used only tracks S00-S22, it was 
actually capable of reaching track S23. Some of the software began using 
this track for program information. All copy programs at that time war* 
incapable of copying track »23, so that when a copy was made, some 
information was lost. This method proved to be very dangerous, bocauss 
some disk drives could not reliably read Or write to track tZZ. This 
means that you could not even use the original protected disk on that 
drive, since it could not read that track. 

At this point, the protection methods started to become more 
sophisticated. State of the art had progressed to the point where the 
manufacturers were actually changing' the format of information on a disk. 
At first, this was done by changing the checksum for the address field on 
the disk. This Mould cause I/O errors which would halt the copy process- 



Locksmith 6.0 



Page 4 



User's Manual 



Disks which were protected by changing the format of information required 
their own Disk Operating System. 

At approximately the same time, some manufacturers started changing the 
formarof the address field on a disk sector. Normally, the format is to 
have an address header, followed by information concerning ^"^^ ^f """' 
track, sector and checksum. This was follow«l by an address The 
order of the volume, track and sector was changed P"* iP.^, t„ 

different format. For example, one company changed '•1^^^"'=*°^ *° 
be even numbers. Instead of sectors O, 1, 2. 3 etc., they used nu-b«-. of 
O, 2, 4, 6 etc. Normal DOS could not understand these formats. 

The headers and trailers for both the address fields and ^^^a fields were 
Changed as the next type of protection. Since MS °oks ' '^^^^^ 

header or trailer to read a sector, it will never find a sector on this 
^ype of disk, on these disks, it. would impossible to read any 
information with a normal DOS. 

Once aaain an entirely new technology appeared for protection. Up until 
T". ??me?'an Tnf^malion was stored on a disk in Tr-ck /Sec tor format. 
Ki^l tracks started to appear using pseudo-sectors. A pseudo-sector is a 
^ong string oJ dlta, -ith only a dita header of some type Some of these 
iTJt^l-llclarl were' an entire track in length. None of the P-^-- 
reading Track/Sector format could decode this type of f^^^" ^J^j 
advent of pseudo-sectors, nibble copy programs became necessary. Until 
thirtime, it was usually possible to modify normal DOS. to copy these 
d?srs This was no longer possible. Shortly after P""f°-»«^*°^* 
appeared. Locksmith was first introduced. It was capable of copying 
tracks which were in a non-standard format. 

loutd^e^lt in a CId copy, even though all of the information was 
transfer ed. 

Another type of protection which was concerned not only with the actual 

" ^ ^Td-r^heTac^ b^rk-ar-rcLnt^^r^hr^" 

: tV^l roCld-r scored on disk Upon --ing thesis 

would look for the track to be that specif ic length S^nce very few 
drives run at exactly the same speed, the chances were very un y 
the track length would be the same on a copied disk. 

the read/write head, it is not possible to ^i^^er. it is 

and half tracks without experiencing cross-talk P^^ohlems. J.^^, 
possible to write data on half-tracks, providing '^-"'"f^*^" 

not used. It then became necessary to "P^ P^f^^^^th this ^ype 

capable of reaching these half-tracks. One major problem with this type 
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of protection scheme is that not all di&k drives are capable ai reaching 
half-tracks. Some very popular drives can only reach integral tracks, and 
disks using this type of protection can not boot on these drives. If you 
are using Hicro-sci type A40 drives with your Apple, keep in aind that 
half-tracks can not be accessed, although all other LocksMith functions 
work as documented. 

There was one type of protection which appeared and shortly thereafter, 
disappeared from the narket. This type of protection actually physically 
damaged the disk. A scratch was made on the disk with a sharp instrument. 
When booting, the disk would attempt to write and then re-read data on the 
track with the scratch. If the test passed, it meant that the disk was 
not damaged, and therefore, not an original disk. This was a very 
undesireable method, since the damaged portion of the disk would need to 
come in contact with the read/write head on the disk drive. Mhen the head 
was over the damaged track, you could actually hear a 'tick-tick' as the 
scratch hit the head. This could cause damage to the head, and because of 
that, the method was quickly abandoned. 

Thie chief difficulty in copying protected disks was identifying which 
nibbles on a track were normal, and which nibbles were self-sync. 
Locksmith versions 2, 3, and 4 attempted to identify self-sync nibbles by 
context, that is by the surrounding nibble patterns. Up until this time, 
disks used nibbles with a value of *FF for self-sync nibbles. It was a 
fair assumption that a string of SFF nibbles represented fields of 
stflf-sync. To combat this, manufacturers started to use different values 
far self-sync. This made identifying self-sync nibbles more difficult. 
In some cases, multiple nibbles were used, for example SD5 SAB SDS MB, 
etc. Because Locksmith identified self -sync nibbles contextual ly, 
parameter changes were required for copying disks of this type with 
Locksmith versions 4.1 and earlier. 

One very sophisticated method of protection appeared on the market shortly 
thereafter. This method required that specific nibbles in the middle of 
normal data be special self-sync nibbles. By using timing routines, it 
was possible to determine if this nibble was normal, or special. This 
special nibble is called a data-latched nibble. When reading a track of 
nibbles normally, the data-latched nibble was indistinguishable from a 
normal nibble. Copying these tracks was very difficult, since it required 
actually breaking or deciphering the code to determine which nibbles had 
to be data-latched. This method was very effective, and has been in use 
for quite a while. Locksmith 5.0 was capable of determining self-sync 
nibbles while reading them without regard to context nibbles, and it was 
able to detect data-latched nibbles without any user-supplied parameters. 

As mentioned before, it is not possible to write adjacent tracks and 
half-tracks. This is due to the fact that the read/write head is wide 
enough to overlap onto the adjacent track or half-track, effectively 
erasing information. To alleviate this problem, the concept of spiral 
tracks was invented. This is simply writing approximately 1/3 of a track, 
Jump out a half track, write another 1/3 of a track, etc. By using this 
method, adjacent tracks and half-tracks may be used without actually 
writing any data closer than one full track apart. The data on the disk 
actually seems to spiral in tOHard the center of tha disk, hence the name 
'spiral track'. 

The most recent type of protection is much the same as half-tracks. It is 
the use of quarter tracks. While it is true that the disk drive is not 
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normally capable of reaching quarter tracks, it is possible to drive the 
stepper motor on the drive so that it will stop on the quarter track. 
This requires some very special timing routines. It works basically the 
same as half-tracks, and the same restrictions about adjacent data apply. 

Locksmith 6.0 is capable of handling all of these types of protection 
methods, along with many others. Due to its extreme f 1 e;< i bi 1 i ty, it will 

also support many protection methods which have not yet appeared. 

If, while using Locksmith, you find a particularly useful suggestion or 
technique that you would like to see included In a future release of 
Locksmith, please let us know. 
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COMMOIM LOCKSM I Tl-I C;or>4TF«Ol_ KEYS 



ThrM fcayatrokM Iistad in tha Lacfcaalth Mln Mnu can ba typad at any 
tiaa, Mhathar In tha aain aanu or not. Thaaa kaya ara tcantroI-ZI, CEBC], 
and tha [RESET! kay. 



[control -Z] 

Praaalng 'CTRL-Z' at any tiaa will print tha taxt acraan to a printar. 
Tha printar ahould ba turnad on and anablad. Lockaaith aaauaaa that tha 
printar intarfaca ia inatallad in Slot 1, but aay ba changad to any alot 
by changing tha paraaatar naaa 'PRT.SLOT'. 



EESCl 

Tha ESC kay may ba prassad at any tiaa to abort a function, and placa you 
in an aarltar aanu. Praaaing thia kay will avantually bring you back to 
tha Lockaaith aain aanu. 



[RESET3 

To aMit Lockaaith and ra-boot your ayataa, praaa tha RESET kay Mhila 
holding down the CTRL kay. 



IMF»aRT«IMT LOCKSMITH I MFOF«M«"T I OIM 

Whan the prompt 'PRESS SPACE TO CONTINUE' appears in flaahing charactera 
at tha bottoa of tha acraan, you aay praaa tha apaca bar to continua, or 
praaa tha ESC kay to abort tha function. 

Tha antira Lockaaith prograa ia too large to fit in tha aa a ory of your 
Apple at one time. It ia loaded froa disk into aaaory in aactions called 
"over 1 ays" . It is important to keep your Locksmith disk in the boot drive 
until instrijcted to Insert other disks to process. If an overlay is 
required to be loaded, and the Locksmith diskette ia not inserted, you 
Mill ba proaptad to ra-inaart tha Lockaaith disk. 

When a Lockaaith function ia invoked which requires you to insert 
diskettes either for input or output, you will be prompted to insert them 
before tha function begins processing.* Signal that the diskettes have 
been inserted by pressing the space bar. If at any tiaa you wiah to 
cancel or abort a function, praaa tha ESC kay. 



THE TRACK STATUS D I SF»L A V 



The top 7 lines of tha Lockaaith acraan ara rmmmrvma for tha track atatua 
diaplay. 

This display shows the status of tha last operation on each track of the 
diskette. Tracka are numbered froa 00 to 22 (in hexadecimal, which is O 
to 34 in decimal). A position for track 23 is provided because some early 
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protection techniques made use of this accessable but normally unused 
track . 

Although most Apple software only uses integer tracks from 00 to 22, the 
Apple disk drive is actually capable of moving the head between tracks. 
For this reason, four lines are provided for each numbered tractt. The 
topmost of these four lines contains the status codes for integer track 
numbers such as DO, 01, 02, etc. The other 3 of the 4 lines contain track 
status codes for 1/4 tracks, half-tracks, and 3/4 tracks, respectively. 

Shown below is an example track status display. 

THE LOCKSMITH - VERSION 6. - REVISION A 

.00 O 

.25 

.50 4 
.75 5 
HEX OOOOOOOOOOOOOOOOMUlllUllll 1112222 
, TRK 0123456789ABCDEF0123456789ABCOEF0123 



The example shows status code O for track OA, status code 4 for track 
13.5, and status code 5 for track IB. 75. 

Status codes are dependent on the individual Lockaaith function currently 
running, and are described separately. 
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GE-TTIIMG STARTED ■ 
BACK X NO l_IF> A DISK 



Thara are several functions within Locksmith which are capable of bacl-ing 
up a disketta. Mhich ona you mil want to use depends on the diskette you 
Mifih to copy. 

H the diskatta >• not copy-protactad, usa the FAST DISK BACKUP function 
by pressing 'F' from the nain menu. 

If the diskette is copy-protected, use the TEXT EDITOR Backup function 
CT' from the main menu, 'B' from the text editor menu) and determine if 
the name of the program is in the list of supplied parameters on the 
parameter diskette (included with Locksmith). If the name is found, 
Bsiect the name and the backup operation will begin automatically. 

If the name is not found on the parameter diskette, Try using the standard 
copy routines by selecting BACKUP/COPY (key 'B') from the main menu. Most 
protected software can be copied using the standard backup/copy function. 

If you used parameters on the parameter diskette to backup your disk, but 
are still unable to successfully backup your disk, it is possible that a 
different protection technique is being used (or that particular piece of 
software. Software companies frequently change protection techniques to 
make it as confusing as possible for those trying to copy the software. 
Call or write our customer support group to find out if new parameters are 
available for your particular software. 

Finally, if you are technically experienced and enjoy challenges, you 
might consider developing parameters to copy the software yourself. 
Locksmith has many useful tools to help you determine the type of 
copy-protection and help you either copy the software or disable the 
protection. 
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the: lochjsm I ti-i r-i<^ i i-iE:rsiLJ 

Immediately after booting your Locksmith disk, the main menu appears. 



THE LOCKSniTH - VERSION 6.0 - REVISION A 

.00 

.25 

.50 

. 75 

HEX OOOOOOOOOOOOOOOOi 1 1 1 1 1 1 1 1 1 1 1 1 1 1 lOOOO 
TRK 0I23456787ABCDEF0123456789ABCDEF0123 

B BAGKUP/COPV F FAST BACKUP / CUR STATUS 

N DISK EDITOR L LOAD RAM CD t PARAMETERS 

T TEXT EDITOR R RAMCD UTILS Q SCAN DISK 

A BOOT TRACER C CERTIFY DSK U 16-S UTILS 

D DOS3.3 UTIL X DSK RECOVER S DISK SPEED 

E ERASE DISK 

I INSPECTOR 

CTRL-Z PRT SC RESET EXIT LS ESC RESTART 



The top 7 lines of the display are the track status display. 

The body of the main menu displays the keystrokes (in inverse) which you 
may enter at this time and a brief description of what function each key 
performs. The functions available in the main menu are each tfiscuased 
separately in this manual. Briefly they ares 

CBJ BACKUP/COPY - This function allows you to backup protected software 
using the Locksmith standard copy routines, Mhich Mill backup most 
protected software without parameters. 

if: FAST BACKUP - The Fast Backup function allows you to quickly create 
backup copies of any unprotected software. Depending on the amount of 
memory in your system, this utility can backup a disk in as little as 8 
seconds ! 

t/1 CLR STATUS - Pressing the key will clear the track status display 

at the top of the screen. 

CNl DISK EDITOR - The Disk Editor (formerly the Nibble Editor in earlier 
releases of Locksmith) can be used to manually read, search, change, and 
rewrite data, either in sector format or nibble format. In addition, the 
Disk Editor is used to edit DOS and PRODOS files, and can be used to edit 
data on any RAM cards installed In the Apple. 

CLJ LOAD RAM CD - This function will load a slot O RAM card on an Apple II 
or Apple II Plus, or load the built-in 16K RAM on an Apple //e or Apple 
//c. This function loads 12K of data which la found on tracks 12, 13, and 
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14 (hex) of the Locksmith disk. It you own Inspector *nd Watson, you can 
write them to these tracks, and they will be loaded whenever you select 
this function. Once loaded. Inspector and Watson are available by 
pressing the M' key froe the nain nenu. 

C«3 PARAMETERS - Thie function allows you to display ar change the current 
Locksmith operating parameters by name. For a compli?te list of all of the 
Locksmth parameter names, please refer to the Locksmith Technical 
Reference Manual. 

CTJ TEXT EDITOR - The Locksmith Text Editor is used to edit files 
containing Locksmith Programming Language (LPL>, which can be loaded and 
saved to your Locksmith parameter disk. The BACKUP function of the text 
editor will allow you to aatomatical ly backup pwotected software after 
specifying the name of the software. 

IHl RAMCD UTILS - The Locksmith RAM card utilities can be used to test RAH 
cards in the Apple. RAM cards of any size can be tested, and two tests 
are provided: a basic test and an extensive test. Ilie test can be 
performed once or continuously to help isolate intermittent errors. In 
addition, the contents of any 16K bank of the RAM card can be clumped into 
main memory, edited with the disk editor, and re-loaded to the RAM card. 

CQl SCAN DISK - Formerly known as "quick scan" in earlier versions of 
Locksmith, this utility allows you to examine on the hi-res graphics 
screen an overall "picture" of the diskette, track by track. This 
function is useful in determining how each track of an unknown disk is 
formatted. 

CAl BOOT TRACER - The Automatic Boot Tracer is intended for use by the 
more e.-:perienced Apple programmer. It is actually a sophisticated 
debugger which can simulate the operation of the 6502 in the Apple. 
Because disk reading is simulated, it is possible to actually "boot" a 
disk (whether protected or not) under control of this debugger and trace 
the boot code Of the program. 

[C3 CERTIFY DSK - The Certify Disk function will write a special pattern 
to each track of ttie diskette and immediately read it back to make sure 
that no scratches or other imperfections on the diskette surface will 
affect the reading and writing of data to the (tiskette. 

tui 16-S UTILS - This menu option will bring up a secondary menu 
containing useful 16-sector utilities. These utilities can be used to 
verify a diskette, compare two diskettes, format a diskette, or display 
the "sync signature" of a diskette. 

101 DOS3.iS UTIL - This menu option will bring up a secondary menu 
containing useful DOS 3.3 utilities. These utilities can be used to 
alphabetize a catalog, undelete a file, load a DOS file into memory for 
examination by the Disk Editor, show a disk free space map, fix incorrect 
sector counts in the catalog, identify and correct catalog/VTOC errors, 
and remove DOS from a disk to allow for the storage of more files. 

CX] DSk RECOVER - The Advanced Disk Recovery utility will read a difficult 
or impossible to read diskette and write a good copy to another diskette. 
This is especially useful for recovering data from diskettes which were 
written in drives which were aligned improperly. Advanced Disk Recovery 
will actually recover data from a diskette which Mars written while 
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inserted in the disk drive off-center' 

tS] Disk; SPEED - This utility will allow you to check the speed of your 
disk drives so that you may adjust the speed to the standard 300 R.P.M., a 
recommended speed which is slightly slower, or set the speed of the drive 
to the same speed that created a given diskette. 

tE3 ERASE DISK - This function is used to entirely or partially erase m 

diskette. 

Ill INSPECTOR - Invokes Inspector and Matson if the utility programs are 
available «>r have been previously loaded with the 'L' menu item. 

CESCl RESTART - At any time during the operation of Locksmith the 'ESC' 
key may be pressed to abort the current function and return to the 

previous menu or main menu. 

CCTRL-z: PRT SC - To print the contents of the text screen to the printer 
at any time during the operation of Locksmith you should hold down the 
'CTRL' key and press ' Z' . 

CRESETl EXIT LS - To exit Locksmith hold down the 'CTRL' key and press the 
'RESET' key. This will cause an immediate reboot. 
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Bf^ChA-IP y COF-V DISK 



CBl BACKUP/COPY 

Pressing 'B' +ron. the main Locks«ith menu will allow you to make a backup 
copy of most protected so^twar.. I* th« disk you wish to backup is not 
protected, you will want to us> th« much faster FAST BACKUP utility <k«y 
'F' from the main «wnu>. 

The 'B' (backup/copy) function uses the standard copy routines, which work 
Hell for most protected software. To use copy routines which are already 
tailored for a specific protected diskette, use the main menu 'T' (text 
editor) function to select the name of the program you wish to back up. 
See the text-editor section of this manual for more information. 

After pressing 'B' from the main menu, you are prompted for input and 
output drives. If you specify the same drive for both (if you have only 
one drive), you will need to swap disks for each track to be copied. You 
are then prompted for the range of tracks for the copy operation and the 
track increment. To use the default values displayed for tract start, 
track end, and track increment, you may simply press the RETURN Vey. 
After specifying whether the tracks should be synchronized and whether the 
track length should be preserved (a technique known as "nibble counting ), 
you will be prompted to insert the diskettes for the copy operation, and 
the bacKup will begin. 

The track status display at the top of the screen will contain the status 
codes for each track copied. A zero indicates that the track copied with 
no errors. Other codes indicate errors which have occurred while copying 
the trac^. Since the status codes are dependent on the LPL (Locksmith 
Programming Language) being executed, refer to the individual LPU file for 
a description of status codes and error messages. 
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F^#=»ST DISK B#=»CKtJF* 



CF3 FAST DISK BACKUP 



Pressing 'F' from the Locksmith main menu will enter the Fast Disk Backup 
utility. Fast Disk Backup (FDB) is intended to be used to backup 
unprotected diskettes. 

FDB is very fast. It reads a disk in as little as B seconds, and writes a 
disk in about the same amount of time. Optionally verifying the written 
data by reading it back and comparing it requires another 8 seconds, if 
it's desired. 

Locksmith FAST DISK BACKUP is the FASTEST Ajpple COpy program with or 
without the use of RAM boards. 

Locksmith 6.0 FDB can automatically switch between two drives and write 
disks from memory, producing a net* disk every B seconds. This is very 
useful for mass-production of Software for clubs or software 

manuf actur ers. 

FDB will automatically recogniie any RAM cards in your Apple, whether they 

are in slots 0-7 or in the auxiliary slot of the Apple //e. The auxiliary 
64k present on the Apple //c is also used. Both the Apple //e and Apple 
//c have a built-in 1 6K RAM which appears as slot O. RAM boards from 
several manufacturers, including Checkmate Technology, Applied 
Engineering, and Titan Technology have been tested with Locismith 6.0 and 
work well. Locksmith FDB will recognize 16K, 32K, 64K, 128K, and 256K RAM 
cards. To copy an entire disk into memory requires t40K (4K per track). 
FDB uses 40K of main memory for track storage, and therefore needs lOOK in 
RAM cards to make one-pass copies or copies entirely from memory. All 
slots, including slot 3, are searched for RAM cards. 

Insist Di sl< B ^ n: l< i-Ji F» Comm^r-ids 

Simple commands are entered from the keyboard. After pressing the return 
key, the current command can be seen in the current command display area 
in the lower left of the screen. The default command is "12", which means 

to copy drive 1 to drive 2. 



A complete list of commands: 



12 


copy 


drive 1 to drive 2 


21 


copy 


drive 2 to drive 1 


1 1 


copy 


drive 1 to drive 1 


22 


copy 


drive 2 to drive 2 


1 


read 


verify drive 1 


2 


read 


verify drive 2 


lO 


copy 


drive 1 into memory 


20 


copy 


drive 2 into memory 


01 


copy 


memory to drive 1 


02 


copy 


memory to drive 2 


V 


turn 


ver 1 f y~af ter-wr 1 te flag on or off 



Cspacel or treturnl begins the copy or verify operation 
Cresetl exits Fast Disk Backup 
Ccontrol-ZJ prints the screen to a printer 
Ccontrol-Xl cancels the key entry 
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In addition to the commands listed above, there are several parameters 
Mhich can be oodi-ficd from within FOB. Th*M p«raaeters can be used to 
allOM FOB to read and ««rite sactor oriented protected disis, and set 
internal FOB operating parameters. Here is • list of some of the more 
useful parametersi along with th«ir initial default values, and a 
description. 

0007"00 Requested output volum number or zero, if same as input 
volume. 

0008=00 Begin track to process. 

0009- 22 End track to process. 

0010- 08 na:<imum read retry count. The retry number is displayed as 

1-9 for the first nine revolutions of the dist and A-2 for 
the next tMcnty-six. After that the display mill not 

change. 

0011=03 Mauimum verify after write retry count. 

0012- 10 Motor On delay for read. Maximum value is 7F. 

0013- 10 Motor On delay for mrite. Maximum value is 7F. 

0014- 80 Seel Off delay for read. DOS uses FF, the longest value. 

A value of 00 is satisfactory and will reduce the overall 
copy time by about a second. 

0015- 80 Seek Off delay for write. It is not recommended to change 

this value below 80 because the drive may begin writing 
before the seek mechanism has settled. 

0016- OB Number of self-sync before address field. This number is 

expressed in excess-S notation. For example, the default 
of OB Mill write sixteen self-sync nibbles and the value of 
01 will write 6 self-sync nibbles. Setting this value very 
low will create a disl which cannot be written to because 
writing a data field would over-write the subsequent 
address field. Setting this value too high will cause a 
problem fitting all of the sectors on the track. 

0017- 08 Number of self -sync before data field. If this value is 

too low, neither DOS nor FDE< will be able to read the data. 
Setting this value too high will cause a problem fitting 
all of the sectors on the track. 

0018- 00 Alternatm writing to drive 1 and 2. Setting this flag to 

FF Mill caus* FD6 to alternate writing itatwcen two drives, 
allowing for very fast and efficient disk copying from 
memory. 

To change parameters within FDB, enter the 4-digit address and press 
return. The current value will be displayed and you can key over the 
value to change it. 

While the copy operation is in progress, the ESC key can be used to 
cancel/abort the copy operation. The 'V key can be used to turn on or 
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turn off the ver i f y -af t er -wr i t e flag. 



Locksmith will read and write a disk without RAM boards in 19 seconds, 
copying 10 tracks per pass. If verifying after each write, the disk is 
copied in 26 seconds. 

The following table summarizes timing tests done with some popular copy 
programs without the use of RAM boardst 



time time to 
trks/ to copy & 
Program pass copy verify 



Loct-smith 6-0 


10 


19 


26 


Penulta Copy 


5 




38 


Disk Muncher 


7 


26 




Pack Rat 


4 


35 




Apple COPY A 


8 


88 





Also note that Disk Muncher and Pack Rat do NOT validate checksums during 
read, and are thus extremely unreliable. 



If RAM boards are found to total at least lOOK (128K RAM boards work 
fine), the disk can be read in 8 seconds, and a copy disk written in 8 
seconds. If veri f y-af ter-wr Ite is desired, the disk is written in 15 

seconds . 



The following table summarizes timing tests done with some one-pass copy 
programs with the use of 12aK RAM boards! 





time 


time 


time to 




to 


to 


write <• 


Ft ogr am 


read 


write 


ver i f y 


Loc ksm 1 th 6.0 


S 


8 


15 


CopyWr i ter 


24 


16 


23 


Copy Cruiser 


9 


16 


23 



Note that Copywriter also has a 'read-twice' mode which ta^es 15 seconds 
to perform instead of 24 seconds, but can be more reliable on original 
disks recorded on questionable media. 
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C/: CLR STATUS 

Th> track status display at the top of th« screen is not cleared after 
•ach Locksaith function, so that the user can use the status display with 
other functions. To clear the status display, press the '/' key from the 
main auHiu. 

DISK, |SIIBBI_E, AND MEMORY EDITOR 
CNl DISK EDIT 



preasinQ 'N* from the main menu Mill select the Di^»K Editor. This 
function Mas referred to as the Nibble Editor in previous versions of 
Locl-ainith, but it has been expanded to be able to edit sectors, entire 
tracts of sectors, DOS files, and RAM card data in addition to disk 
nibbles. The keystroke 'N' to invoke it has been kept for compatibility 
with earlier versions of Locksmith. Some text in this manual may still 
refer to it as the Nibble Editor. 

The following single keystroke comoands are supported by the disk editor: 



CESCl 

Pressing the 'ESC key will always abort the current operation and 
return you to a menu. 

CCTRL-Z] 

This option is activated by pressing and holding the key marked 
'CTRL' and pressing the 'Z' key. This option is a screen print. It Mill 
print whatever is showing on the te;<t screen at the time it is pressed. 
This IS assuming that you have a printer turned on and that Locksmith has 
been told the correct slot for the printer interface card. 

Now we Mill cover how to Move around within the buffer. 

CURSOR MOVEMENT: 

The disk editor cursor consists of a flashing box on both sides of the 
nibble or byte of data. 

Locksmith supports the normal Apple II cursor movement keys. 

UP 
CIl 

LEFT CJ3 tKl RIGHT 
CM] 
DOMN 

You may also move left or right with the le+t and right arrow keys. 

If you have an Apple //e the up and down arrow keys are also operational. 

If you move left past the beginning of the line, you will be placed on the 
last character of the previous line. Similarly, if you move past the end 
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of the current line, you will be placed at the beginning of the next line. 



Pressing the '<' key will move backwards through the buffer one 
screen page, unless you are already at the beginning of the buffer. 

[>3 

Pressing the ' >' key will move forward through the buffer one 
screen page, unless you are already at the end of thm buffer. 

Pressing the ',' key will allow you to scroll continously back 
through the buffer until either a key is pressed or you reach the 
beginning of the buffer. 

C.I 

Pressing the '.' key will allow you to scroll continously forward 
through the buffer until either a key is pressed or you reach the end of 
the buffer. 



DISPLAY CONTROL COMMANDS: 
CA3 

This key toggles the display of ASCII data to the right of the hex 
display. The ASCII display is normally meaningless for nibble data, so it 
IS normally turned off. 

CBl 

This key toggles the display between nibble mode and byte mode. 
In nibble mode, self-sync nibbles are displayed in inverse text, while 
normal nibbles (not self-sync) are displayed in normal te;<t. In self-sync 
mode, all data is displayed with the high order bit turned on, because all 
nibble data by definition has the high order bit on. In byte mode, all 
data is displayed in normal text with the high order bit of each byte left 
intact. 



CONTROL KEY COMMANDS: 



Pressing 'CTRL-R' will allow you to read a track into the buffer. 
You will be prompted with TRACKS. If you have previously read a track 
into the buffer, that track number will also be displayed. The Current 
default drive for the track read will also be displayed. If you wish to 
reread the same track just press the RETURN key. If not then enter the 
number of the track you wish to examine. You may enter a decimal point ll 
the track number. The track number you enter will be multiplied by four 
before it is stored internally. This is necessary duo to the way 
Locksmith finds the tracks specified. After you have entered the track 
number you wish, press the RETURN key to tell Locksmith you are finished 
with the entry. The cursor will move to the drive entry to allow you to 
change the default if you wish. If you want the default drive, press 
RETURN. The first time you read a track into the nibble buffer Locksmith 
will recalibrate. If you wish to recalibrate at any other time enter 
CTRL-R and when the prompt TRACK: appears enter the track number, follows 
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by 'R' and press the return Key. This mil farce Locksnith to 
racalibrata. 

CCTRL-W: 

Entering a 'CTRL-W tvlls Locksmith to write the current track 
back to disk. You will be prompted with TRACK:. Enter the number of the 
track you wish to be written to the disk followed by return. Pressing 
return will write the data to the current track that was read. Next the 
cursor will be placed on the default drive number for the write. If you 
wish to use the default drive just press RETURN. If you wish to change 
the default, enter the number of the drive you wish to write to. 
WARNING' IF NO ANALYSIS HAS BEEN DONE ON THE TRACt IG SET THE TRACK START 
AND TRACK END LOCKSMITH MILL ATTEMPT TO WRITE THE ENTIRE BUFFER. 

CCTRL-V] 

This command is used to tell Locksmith where to start verifying 
the track start after it writes the track to the disk. The series of 
bytes that follow the verify start are the ones that are checked when the 
track IS written to disk. This is done to mate sure that the beyinning of 
the track was not overwritten and destroyed by the end of the track. 
Normally, if the verify bytes are oveerinri tten the track will be shortened 
and rewritten until they are not overwritten or until the track can no 
longer be shortened. If the track can no longer be shortened you will get 
a verify error. This error may possibly be corrected by adjusting the 
copy drive to a slower speed prior to writing the track. 
To set verify start, place the cursor on the nibble you wish to start 
verifying, and press CTRL-V. This will set the verify start to this 
location. There will be a 'V displayed in front of the nibble you 
selected for verify start. 

rCTRL-n 

This command is used to add nibbles to the current buffer- When 
you enter 'CTRL-I' the nibble that is at the current cursor location is 
duplicated and all the nibbles to the right are moved one position to the 
right. 

:cTRL-n: 

This command is used to delete nibbles from the current buffer. 
When you enter 'CTRL-D' the nibble that is at the current cursor location 
IS deleted from the buffer and all the nibbles to the right of the cursor 
are moved one position to the left. 

rCTRL-Fl 

This command is used to find different patterns of nibbles within 
the buffer. Enter CTRL-F, and you Mill sea the prompt FIND:. The Find 
Command has two options: 

C RETURN I 

Pressing the return key will cause find to use the pattern in 
the string variable PATO. You can set this variable witti ttie LPL 
command processor described elsewhere m this section of the manual. 



CL] 

Entering 'L' will give you the prompt LENGTH:. You may now 
enter in a length from (l-F). This instruction tells Loclsmith to 
start looking forward through the buffer for a pattern that matches 
the one that starts at the current cursor position and is LENGTH 
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nibbles long. When the pattern is found, the cursor will he moved 
forward in the buffer to the first nibble of the matching pattern. 
If you wish to repeat the search from your present cursor position, 
type 'CTRL-F' and press the RETURN key. This repeats the last search 
again. If Loci smith is unsuccessful in its search for the pattern, 
the cursor will not move and Locksmith will print in inverse at the 
top right of the buffer 'NOT FOUND' and beep. 

Earlier versions of the Nibble Editor had three other options to the Find 
command. The O (find other), P (find pattern name), and D (find data). 
Because of the capability of using LPL directly from within the Disk 
Editor of version 6.0, these options are no longer needed Mithin the Disk 
Editor. The equivalent LPL commands are: 

NEXT.DIFF finds the next nibble in the buffer different than the one 

at the cursor. This is equivalent to the find "O" (other) option. 

FIND PAT4 finds the next occurrence of the data contained m the 
variable PAT4. This is e<tuivalent to the find "P" (pattern name) 

op 1 1 on . 

FIND OS AA 96 finds the next occurrence of the data supplied by the 
user. This is equivalent to the find "D" (data) option. 



ECTRL-B3 Moves the cursor to track start. If the cursor is at track 
start, the cursor is moved to beginning of buffer at 2000. 

[CTRL-e: Moves the cursor to track end. If the cursor is at track end, 
the cursor is moved to the end of buffer at 7FFF. 

C(] Sets track start to current cursor position. 

[> I 

Sets track end to current cursor position. 
Sets the nibble under the cursor to self sync. 
Sets the nibble under the cursor to normal 



CSD 



CN3 



CC3 

Change mode. Enter hex data and press RETURN to exit change node. 
You may also use the left and right arrow keys and the space bar in change 
mode. This changes the data under the cursor to the hex values entered. 
Pressing the space bar moves the cursor to the next position. The 
commands 'S' and 'N' also work in change mode. 

tHJ 

Entering 'H' will display the current buffer on the hi-res screen. 

CHGl 

Entering a 'G' while in hi-res mode will print the hi-res screen 
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If you have a printer capable of h»-res graphics and a graphics printer 
intBTface card. The printer string required by your printer may be 
defined by the pare 'SRCHARS'. The default is set to CTRL-I G <CR; CTRL-Q 
<CR>. This string works for both Silentype and Epson printers with 
interfaces that support graphic screen dueps. 



Entering a '6" from the text mode of the Nibble Editor will 
display a picture of the buffer using text characters. Each locaton on 
the screen represents a string of nibbles in the buffer. The lenyth of 
the string (sample interval) is defined by the parm ■ TSAMP' , and defaults 
to •OA. (Note: for 13 sector disks, a value of »0C worts well). On the 
graphic display the following symbols are used. A period '.' means that^ 
all the nibbles in the string are noreal (non-self sync). An inverse 
means the nibbles are all self sync. The means the nibbles are a 

combination self sync and normal. 

The cursor may be moved within the screen area using the I,J,K,li keys or 
the arrow leys. The cursor may be moved to the location on the screen 
corresponding to the area in the nibble buffer that you wish to examine. 
Pressing any other key at this point will return to the nibble display 
with the cursor set to the area you selected. 

HINT: The display starts at either buffer start or track start and the 
display may not be centered. Move the cursor to the center of the screen 
and pre^ss the RETURN ley. It will take you back into the Nibble Editor. 
Set track start ■(' and press '6' again. The display will now be 
centered. If the disk you are exaeining is a 16 sector disk, you will see 
one pattern of '»'s that is larger than the others. This is the field of 
self sync in front of sector zero. Move the cursor to the first period 
'.' following the large number of 'H's and press RETURN. You will now be 
back in the Nibble Editor and the cursor should be near the first nibble 
in the address header for sector zero. 



CD] 

This is a 16 sector address decade command. You will see two 
columns displayed on the screen. They are decoded in the following 
manner. 

The first four numbers in inverse are the buffer address. Next is the 
letter 'V* followed by a hex number. This is the volume number of the 

dist. Next IS a two digit hex number followed by a '/' followed by 
another two digit hex number. This is the track number /sector number. 
This field may be followed by any of these three symbols "",'CS','»*' or 
if nothing is wrong it will be followed by a blank space. They have the 
following meanings. The '?' means that either the chect sum or the 
trailer was incorrect in the address field. The 'CS' means the data field 
checksum is bad. The '»»' means there is something wrong with the data 
field information. It is either a bad data field header or trailer. If 
the disk is a 13 sector format, '««' will appear for all sectors. 

As mentioned above, '««' indicate-^ that either the data field header (D5 
AA AD) or data field trailer (DE AA) is Incorrect. If they both appear 
uurrect, but are still marked with '»«*, the trailer is probably in the 
wrong location. Exactly 343 nibbles should occur between the header and 
the trailer. (342 data nibbles and one checksum nibble) A simple way to 
teit this IS to perform the following. Place the cursor on the DS of tfiii 
header field (D5 AA AD). Now, press ' >' (shifted) 3 times, 'I' 5 times, 
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header field (05 AA AD). Now, pre.s (shifted) 3 " ^VV'Xl. 

and k- twice. The cursor is now where the trailer shou d 't*"^*. f the 
ri.rsor is not on the DE of the trailer (OE AA) . the trailer >s not in the 
correct location. 

The address field nibbles occur in double-nibble format after the address 
field header (D5 AA %) and represent the volume "umber, track number, 
liriur number, and checksum. A chart to decode the address field 
double-nibbles is located in the appendix. 

The data field nibbles consist of 342 data nibbles after the 

header (D5 AA AD) plus an additional 343rd nibble, which is used 

d!ta field che.»sum. This checksum IS calculated by taking each of the 

342 dlia nib les. translating them according to a chart (which is supplied 

^n th^ Append X) and ex c 1 us. ve-or ' i ng them together to form a sum 

The resuUmg checksum is then reverse translated using the same table and 

bero,.es the ?43rd nibble. Note that only 64 different n.bb es are 

^n thTs table. Data fields are validated only by this 6-bit checksum, and 

data nibbles each contain only 6-bits of information each. 

If the d,^.k -.-..nq a nor. standard address or data header you wl U not 
recl?veihis information unless you set PARM.SECAF to the correct address 
field pattern am) FARHsSECDF to the correct data field pattern. 

Press. r,g the t ey from withm the Nibble Editor prints the 

. . rr ,M th^ buffer from 'C track start to ' ) ' track end to your 
nrbbl^s wH. have on either side o. them in 

the printout The track verify start will have the letter 'V in front pf 
the verify start nibble sequence. 



IRETUKNl ^ ^^^^^ ^^^p^ ..LpL:" above the data 

, V,, av.nter an LF, statement at this time. The L PL statement 

:V;'b:'a 'r:LL. to d.splay the value of a named — ^^^^^ 

name assignment statement, or a processing routine to invoke. See the 
chapter on LPL for more information. 

tCTRL-Sl ,„„,,ol-S w.U process the analys.s portion of the 

,urren. Irll pr^ocedure. This IS used after reading to analyze the nibble 
data and set pointers for later writing. 
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Th« frMing bit itnal/zsr is intended a% » tool for thia more ddv^nced 
LockMtth u«ar. 

Frogling bits (soaBtimes called "sync bits" or "tiaing bits") *ra tha zero 
bits that occur between some nibbles of data on the dis^. These nibbles 
with (raning bits are called sel<-&ync nibbles. Each bit o< nibble data 
requirxs 4 ml tr os.ec onds to read or nrite. An BLit dibblt; o* r ava disk 
data with no framing bits therefore requires 32 microseconds. For each 
framing bit occurring after the 8-bit nibble, 4 Microseconds are added to 
this tine. A 10-bit (2 framing bit) Mif-sync nibble therefore requires 
40 microseconds to read or write. 

13-sector DOS (DOS 3.2 and earlier) used 9-blt sel ♦ ^yiiL (1 framing bit) 
while 16-sector DOS <DOS 3.3 and PRUDOS) use lO-bit self-sync <2 framing 
bits). It IS also possible to write 3 or more framing bits after a nibble 
of data although if 3 or more framing bits occur, it is more likely that 
sync may be lost by the disk controller while reading. 

Some copy protection techniques rely on ^eii-^ym: data witri a ^specific 
number of framing bits on a specific nibble of data un the track. This 
can be detected in a number of ways. One way to determine framing bit 
information is to cause the disk controller shift register to deliberately 
lose sync. This causes the normally invisible framing bits to be shifted 
into the disk controller shift register. This method doesn't work with 
some models of disk drives. Another method to determine the number of 
franiing bit<a to perform a statistical analysis of the timing of the 
disl data using several reads of the same data. 

The framing bit analyzer performs a statistical analysis using precise 
timing loops and reports the timing relationship of the nibble data. Ttim 
framing bit analyzer reads the track data repeatedly, each time u^J^iting 
cummulative timing s>tatistics for each nibble uf data. After several rmad 
passes, this timing information can precisely determine the number of 
timing bits used to write any nibble of data on the disk. 

The framing bit analyzer is entered by pressing from the disf editor 

after reading in a track from disk and manually setting certain pointers 
in the track buffer. 

Let's use an e^aniple to describe the use of tlie framing bit analy.!i-'r. In 
the disk editor, use the control -R command to read a track of nibbles. 
Place the start pointer on the start of an address field (DS AA 96). 

riove the cursor down about 10 lines and set the end pointer. Now move 

the cursor back up to thm "OE AA" aftar the start of the address field (DS 
AA 96). 

The framing bit analyzer uses the data from the start pointer to the 

nibble immediately before the cursor as a "key". If you placed "(" before 
tha OS nibble and tha cursor on the OE nibble, the key length would be SOB 
(decimal 11) nibbles. 

Enter tlie framing bit analyzer by pressing the key. Tfie iJispi.*y stiows 

ttie data being analyzed on the left side uf the screen with statistical 
information on tha right. 
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The following command keys control the framing bit analyzer: 



The space bar temporarily stops the analyrer so you may e-tamine the 

statistics. Pressing the space bar again will cause a single read to 
occur . 

The RETUf^N key starts the analysis again. 

ESC e::lts the framing bit analyzer and returns to the disk editor. 

"<" and "■>" allow you to scroll through the buffer if it is more than 
one screen in length. 

"T" switches the display from nibble data to tha timing statistics 
information associated with each nibbla. 



The timing statistics information associated with each nibble would be 10 
for an ideal normal S-bit (no framing bit) nibble, 20 for an ideal 9-bit 
(I framing bit) nibble, 30 for an ideal lO-bit (2 framing bit) nibble, and 
so on. Timing statistics between these "ideal" values indicate 
differences between the writing and reading drive speeds and statistndl 
error due to the number of samples read. This error is reduced when more 
samples are taken. 

The information on the right side of the screen is a statistical summary 
of the analysis and might look like the followingt 

R»6007 

F=07 

77 





— **■ 





02 


1 


OO 25 


2 


2S 03 


3 


02 OO 


4 


01 01 


5 


00 I a 


h 


OB OO 


7 


OO 07 


B 


03 



The "R=" value is the number of reads which occurred. The "F-" value is 
the number of reads in wh i i h the "ley" of the data wjs ( uund (jn tr.e track. 
Hecause of limited buffer space, if a large data length is specified, it 
IS possible that the buffer may not fully contain llie data specified. 

The table of numbers represents the count of the differences of the ilat a 
read with the "ideal" values of 10, 20, 30, etc. These error differences 
range from -7 to with 00 being the ideal. For example, in the table 

shown above. Die count < ur tl i s 25 (he~). This means that there are 25 
occurrences of nibbles with timifig values uf one greater than llie ideal 
value (11, 21. 71, etc.). The "8" count of 03 indicates 3 occurrences of 
timing values e::actly halfway between ideal values. This indicates that 
more samples are needed. The "?•"• is displayed when the values for the 
♦/- 6,7, and B counts are non-zero, and indicates that more samples are 
needed. 

When nibble data is displayed on the left side, the inverse/normal mode of 
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each nibble indicates the number of framing bili after the nibble. Nuruidl 
te-t indicates no framing bits. Both digits are invurs« if 2 framing bits 
Htiile only one digit is inv*r» »f t frMing bit. A fldirhina value 
indicatH 3 or mora fraMtng bits. 

If tha nibble d*t* has th« high order bit turned off. this indicates that 
at least one read occurred where the data after the iny did not match. 
This could have been caused by a loss of sync while- admy or by the key 
being specified as too short which caused a non-unique pact of the track 
to ba analyzed instead of tha dastred part. 
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l_C3«D I=t«M CAF^D 



cl: load ram cd 



Pressing the 'L' key from the main menu will cause tracks «12,«I3, and ♦14 
to be read into menory addresses SDOOO through SFFFF of a RAM card in SLOT 
O. If you have an Apple //e or //c, there is a "built-in" slot O 16K RAM 
card already in your system. 

If you own Inspector / Watson, you can place them on your Loci- smith disk 
by using the following procedure and then quickly load the RAM card when 
Locksmith is booted by pressing 'L' from the main menu. 

Your Locksmith diskette already contains a RAM image of INTEGER BASIC and 
the monitor on tracks «13 and »14. To install Inspector / Watson on track 
»12, follow these instructions: 

Boot a copy of a disk that contains your copy of Inspector and 
Watson. Then enter Inspector or Watson, insert a copy of your 
Locksmith diskette and press the following keys: 

B D <return> 
T 1 2 -'return > 
control -W 

Then press the control-I key 15 times. Inspector and Watson are now 
placed on your Locksmith diskette. 
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f»«r«mete:rs 



C»] PARAMETERS 



Pressing the 't' key from the nain menu Mill allow you to display and set 
Locksmith parameters. Parameters are displayed and modified using their 
parameter name (LPL variable name). 

To exit -from the parameter -function press the ESC ( ey. 

To display the value of a parameter, enter the keyword "SHOW" followed by 
the name o-f the parameter. For example, to display the current value of 
the parameter SLOT, entera 

8HCM SLOT 

To change the value of a parameter, simply enter its name followed by the 
value yQU wish to assign to it. For example, to change the value of the 
parameter SLOT to 4, enters 

SLOT 4 

If an error was made in entering the command, the speaker will beep, and 
the command will be ignored. Simply type it again correctly. 

To display the addresses of the parameter names as they are being 
displayed, set the parameter SHOU.ADDR to the value VES, as followsi 

SHOW.AOPR YES 

Now if you enter the coiMiandi 

SHOW SLOT 

the address of the parameter SLOT is displayed in addition to its value. 

Any named Locksmith parameters can be displayed and changed in this 
manner . 

Here are a few useful parameters and a brief description of what they are 
used fori 

SLOT is the slot number of the disk drive Locksmith is to use for 
disk functions. For example: 

SLOT 4 

PRT.SLOT is the slot number which contains the interface for the 
printer to be used for print, print screen and graphics print 
commands. For examples 

PRT.SLPT 1 

GR. CHARS IS a string variable (maximum length of 15) which containii 
the printer setup string which will cause the interface to print the 
graphics screen. Locksmith sends this string to the printer when the 
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•G' key is pressed while a graphics screen is displayed in the Disk 
Scan or Disl Speed utilities. The following statement sets the setup 
string to control-I 'GRD', which will cause Grappler and GrafStar 
printer interfaces to print the graphics screen rotated and 
double-sizes 

a*. CHARS 'BRD' BD 

LS.SLOT is the name of the parameter to change the drive slot from 
which Locksmith will load overlays from. For examples 

LS.SLOT S 

The following statement, while not really a parameter, can be useful 
to assist in reading sectors from a disk that reads unreliably. This 
patch to R-WTS inhibits the recalibrate of the disk head after an I/O 
error occurs and instead will retry the read operation until it 

succeeds. The second statement listed below removes the patch and 
allows normal reading of sectors. Nate that with this patch 
installed that sector reads for a sector that is permanently bad will 
never terminate. If this occurs, simply remove the bad diskette and 
replace it with a good one until the read terminates normally. 

BDCC 4C CI PD 
BDCC 10 F3 AD 
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-TEXT EDITOR / t-F^L- 



CTJ TEXT EDITOR 

Th« LockMith tetit editor is entered from the main menu by pressing the 
'T' key. The text editor is a special purpose file editor which is used 
to edit Locksmith Programming Language (LPL) files. These files can be 
loaded from and saved to a Loci smith Parameter Dl'^lette, which is included 
with the distribution of Loctsoiith 6.0. The parameter distette (sometimes 
referred to as the "parmdisk") is not copy protected, yet is fornatted in 
a special way to maxintze use for saving many parameter files. The free 
space and alphabetical directory on the paradisk is automatically managed 
by the text editor. 

After entering the text editor menu, the display screen will show the 
following choices: 

CLl LOAD FILE 

LSI SAVE FILE 

CD! DELETE FILE 

CX3 SYNTAX CHECt: 

CC: CHANGE SLOT AND DRIVE 

Cn INITIALI2E PARMDISK 

CZ: PARMDISK STATISTICS 

CE3 ENTER EDITOR 

CNI MEM FILE 

tP3 PRINT FILE 

CAl PRINT ALL FILES 

CB3 BACKUP / COPY DISK 



By pressing a single key fron the text editor menu, any text editor 

function can be selected. 



O f 3 I LJ !=• LIS I CUSTOM F^^FtftME TEFiS 

CB3 BACKUP / COPY DISK 

This text editor function is used to automatically select a parameter file 

to be used to had up a disk with a minimum of leystrol es from the user. 
To enter this function from the text editor menu, press the 'N' ley ("NEW" 
clears the work buffer if any file is currently loaded) followed by the 
'6' key (backup / copy). 

If the parmdisk is not in the selected drive you will be prompted to 
insert it. After the parmdisk directory is read into memory, a list of 
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parameter files contained on the parmdisk is displayed. The "light bar" 
will be positioned on one of the names, probably the first one if no 
parmdisk operations have been previously performed. To move the light bar 
to select a di-ffarent fila, you can prass cxia of tha -folloMlng kaysi 

Cup-arroM] and CdoMn-arroM] Mill aova tha light bar up and down. If you 
have an Apple II or II PLUS you can uaa Ccontrol-KI to nova up and 

t control -J] to move down. 

Ccontrol-N] (next page) and Ccontrol-Pl (previous page) can be used to 
scroll ahaad or backward ana coaplata paga of naaaa. 

If you know the name of what you are looking -for, you may enter the first 
character of the name. Tha light bar Mill be inaediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may uaa 
the up and down arrow keys to move the light bar. The left and right 
arrow kays aova tha cursor in tha naae key-in fiald. Tha naaa kay-in 
field alMays shows the current naae selected. 

If Mhile entering a name to select, you enter a character that causes the 
naae key-in field to contain a file name that is not in the directory, the 
speaker will "beep" and the light bar will be positioned On the naae 
closest to the one you have entered so far. 

To select a file name for backup, press the RETURN key. The file Mill be 

loaded from the parmdisk, automatically syntax checked, and control will 
be transferred to the Locksmith backup/copy routines after suitable 
prompts for you to insert the Locksmith diskette and finally, the 
diskette(s) to copy. The backup/copy routines will autoaati c«l 1 y copy the 
proper tracks with the proper LPL parameters. 



l_Of=»I3 <=» F>AF%AMETEF% F=- 1 l_E 

ILl LOAD FILE 

Press 'L' froa the text editor oenu. If the parmdisk is not in the 
selected drive you will be proaptad to insert it. After the paradisk 
directory is read into memory, a list of parameter files contained on the 
parmdisk is displayed. The "light bar' will be positioned on one of the 
names, probably the first one if no paradisk operations have been 
previously performed. To move the light bar to select a different file, 
you can press one of the following keyai 

Cup-arrowl and Cdown-arrowl will aove the light bar up and down. If you 
have an Apple II or II PLUS you can uaa [control -K] to move up and 

[control -J3 to move down. 

Ccontrol-N3 (next page) and Ccontrol— PI (previous page) can be used to 
scroll ahead or backward one coaplete page of naaaa. 

If you know tha name of what you are looking for, you may enter the first 

character of the name. The light bar will be immediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may USt 
the up and down arrow keys to move the light bar. The left and right 
arrow keys move the cursor in the naaie key-in field. The name key-in 
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field always shows the current name selected. 

If while entering a njme to select, you enter a characttr that causes the 
ridme ley-in field to contain a file name that is not in the directory, the 
speaker will "beep" and the light bar will be positioned on the name 
cloMmt to thm onm you h*v« antwed so far. 

Whan th« liBht bar is on the nam* you Mich to select, press the RETURN 
key. The file will be loaded into the »«jrk area. 



ISl SAVE FILE 

Press the 'S' tey. If the parmdisl is not in the selected drive you will 
be prompted to insert it. After the parrodist directory is read into 
memory, a list of parameter files contained on the parmdisk is displayed. 
The "light bar" will be positioned on one of the name^,, probably the last 
n^me you previously used. To use the same name (replace file), simply 
press the RETURN ley. To move the liB^t bar to select a different file, 
you can press one of the following keys: 

TLip-arrow] and Cdown-arrow] will move the light bar up and down. If you 
t jve an Apple II or II PLUS you can use tcontrol-Kl to move up and 
Cuontrol-J] to move down. 

Cuontrol-ND (next page) and Ccontrol-PJ (previous page) can be used to 
scroll ahead or backward one co«pIet> page of names. 

If you ^now the name of an existing file you wish to replace, or want to 
name your file with a similar name to an existing file, you may enter the 
first character of the name. The light bar will be immediately positioned 
on the first name beginning with the character you entered. You may 
ftirthur qualify your suggestion by entering more characters of the name or 
iTid/ use the Lip and down arrow t eys to move the light bar. The left and 
right arrow keys move the cursor in the name key-in field. The name 
I ey-in field always shows the current name selected. 

If while entering a name to select for saving, you enter a character that 
cau-:.es the name ley-in field to contain a file name that is not in the 
dir-ectory, a new name will be displayed in the key-in area with the wards 
"I'.DD FILC;" displdyed. Key over using "the space bar, any unwanted 
characters and press the RETURN key when you are finished specifying the 
lume you wish to save. The name will either be adited or replaced, 
depending on whether the name already exists. 



MEW — c:l_e:«r edit mofck: «f<e<=4 

CN3 NEM FILE 



Pressing the 'N' key from the te:<t editor menu causes the text editor work 
area to be cleared. Any file contained in the wort area not already saved 
on the parmdisk is lost. If you have made changes that you wish to save, 
be sure to save the file before you clear the work area. 
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CM^MCSE SI_OT AND DF* I V/E 



CCl CHANGE SLOT AND DRIVE 



Pressing the ' C key will prompt you for a new slot number and drive 
number of the disk to us* for the parameter disk. Either enter a new mlot 
and drive number or press the RETURN key to use the default values 
displayed. 



F>AFt«METEFt DISK STATISTICS 



CZl PARMDiac STATISTICS 



Press the 'Z' key to display statistics about the parameter disk. The 
information displayed is in two parts. Information about the "CATALOG" or 
directory is displayed first, followed by information about the "DATA" 
portion of the parameter diskette. Shown below is an example parameter 
disk statistics display. 

VUUMHEiLS 6.0 PI 

DISKETTE STATISTICS 

«««•* CATALOG *««•» 

364 FILES 
6071 BYTES FREE 
5705 BYTES USED 

13 AVERAGE FILENAME LENGTH 

ENTRIES WHICH CAN BE AODEOi 
496 AVERAGE FILENAME LENGTH OF 10 
181 AVERAGE FILENAME LENGTH OF 30 

tt«t» DATA «*•«* 

103744 BYTES FREE 
27329 BYTES USED 

75 AVERAGE FILENAME LENGTH 
FILES WHICH CAN BE ADDED: 
1621 AVERAGE FILE LENGTH OF 64 
40S AVERAGE FILE LENGTH OF 2S6 
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CO) DELETE FILE 



Prasming th« 'D' k»v Mill alloM you to dal*t* a singl* fila fro« tha 
paraMtvr dirnk. S«lact a iilm to dalata In th« km* w*y th*t you would 
■•l«ct a 411a to load (damcribad mMrlimr) and praaa tha RETURN kay. Tha 
4>la Hill ba raaovwl «r€i« tha paraaatar diak and tha apaca it uaad 
raclalaad. 



XNI-rXAI_XZE F»«»=*«METER DISKETTE: 



Cll INITIALIZE PARNDISK 



Prassing tha 'I' fc*y from the taxt aditor nanu Hill atloM you to foraat 
dnd initial iza an anpty paraaatar diskatta to atora additional <ile«. 
WARNING: Thia functioo mrM%m* all data on tha targat diafcatta. Entar a 
vQluaa naaa *or tha diskatta. Whan proaptad with "FORMAT?", antar "V" If 
you Mi%h tha diskatta to ba «oraattad or "N" !♦ tha diskatta la alraady 
formatted Mith standard 16 sectors per track. Press the space bar tthan 
prompted, to start tha format and initialization process. 

After tha procass ia coaplata, you aay usa tha disk to sava additional 
paraaatars. 



J ElMTEFt THE TEXT EDITOR 



CEl ENTER EDITOR 



Prassing tha 'E' key Mill antar the text editor. To exit fron the text 
editor and return to tha tent editor oenu, press the ESC key. 

If residue eMists in the Mork area, you can clear it by pressing control-N 
(NEW) froa the text editor or exit the text editor (press ESC> and entar 
'N' <NEM) froe tha text editor aanu. 



LJSINCB THE TEXT EDITOR 



The text editor is a line numbered editor. All lines entered are given 
sequential line numbers, Mhich are displayed in Inverse text on the 
leftaost tMO positions of each line. The line numbers are displayed in 
hex. Line numbers are used only for referring to a portion of a file Mith 
the -.1* (include) directive of UPL. 
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Lines in the tent editor are displayed one line of text per one line of 
the Apple 40~inlumo display. With ^ positions used for line number, 38 
positions are alloMvd lor the aaniMua length of a text line. If it is 
necessary to continue an LPt St atem en t on the next line, key a alnus sign 
<"-"> as the last character entered on the line to be continued, tmy 
number of lines may therefore be used to contain an LPL stataaant. 

f 

'here are t wn ruranr* used In the text editor. If the line number is 
flashing, the cursor is on the line number. If a single charactsr on the 
line IS flashing, the cursor is Mithin the line of text. This is 
important for the Insert and delete functions Mhich are described later. 

lo enter » e« t , simply type the statements you Mish folloMed by the RETURN 
l-ev- The return l-ey causes the cursor to go to the next line. The 
ha(fc%p«ce l>ev (left arrow) is used to backup the cursor one character 
position If It IS Ml thin a line of text and move up one line if the cursor 
I s on all ne number . 

Tn adit an existing line, use the RTTURN key or the left arroM to position 
the cursor on the line number of the line to be edited, and usa the 
right arroM to move the cursor onto the text lina. Simply key over data 
on the line to 'change the data. 

To insert or delete characters on the line, position the cursor Hithin the 
line over the rharacter you mi sh to delete or insert before, and press the 

control I key to insert blanks or the control -D key to delete characters. 

To insert or delete entire lines of text, position the cursor on the 
number of the line and press the control-I Icey to insert blank lines or 
the control D key In delete lines. 

To exit from the text editor and return to the text editor Menu, press the 

ESr key. 

A summary of the text editor commands I 
E5C exit the text editor 

ctrl-N NEW - clear Morkarea 

fIFTURN moves cursor to the line number of the next line. 

< If the cursor is on a line nuaber, aioves it up one line. 

If the cursor is Hithin a line of text, moves it left one 
character position. 

moves the cursor one position to the right. 

ctrl-I if the cursor i s 1X1 a line number, inserts a blank line. 

If the cursor is Mithln a line of text. Inserts a blank 
c har ac ter . 

ctrl-D If the cursor is on a line number, deletes the line. If 

the cursor is Mithin a line of text, deletes the character. 

tupl this arroM key or ctrl-K iioves the cursor up one line. 



Lockseith 6.n 



Page 3S 



User's Manual 



IdOMtJ thi» *rram kmy or ttrl-J may th« curmor ilomn una l»rM». 



8VNTAX CHECK 
(m SVNTAX CHECK 

Pr»««ing th« '«• kmy Mill c«uma the t«Kt ♦il* m th« ~ur k <r»< to b* 
■canned ♦or Bynt« •rror>. In doing >o. all ".I" in«I..J. dir-ttivt-* *r » 
• xpandad, using tha «>!•• which tl»»y r««»r«nc«. I< you .1 command* in 

your taKt, !>■ •urm to Mva th« «il« l»»«or« you •ynt«K chmtk, b«cau»« 
kyntaii clHick Mill Chang* tha *>!• in ■■w o ry. 

A«t»r v.panding any .1 coMandm and ayntaic chacking th« raaulting LPL 
mtatamantm, tha MaBkaga "SVNTAX CHeCK SUCCESSFUL" Mill appaar il no arrors 
Mara lound. 

11 any wr r or % -arm «ound, tha ta»t ad i t or is •iit»r»d xith tha cur BOr on 
th« kt^tamant that caubad tha mr r or ind tt.» Mill baap. No 

chacking la dona oayond tha lirat mrror that occur ». 



IPl PNINT FILE 

pra»*ing tha 'P' kay fro* tha tant aditor manu mil print tha currant till 
in tha Morkaraa. Tha standard printar mlot is usad (da«*ult of slot I), 
but aay ba chanqad by satting tha ftM-»tmtmr 4or tha printar slut to a 
di<larant valua. 



F»RIMT Al-I- F>«I=»«I-1ETEFI »=■ ILES 
lA] PRINT ALL FILES 

Prassing tha 'A' kay Mill print tha antira contants of tha paraaatar disk, 
ona *ila at a tiaa, in alphabatical ordar. 
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Kf^M c:ai-<l> lj r 1 1^ X t I eies 

(HI RAMCHO UTIL 

pra»>ing 'H' <rQ«i tha Lockaaith Main nanu Mill display tha RAM card 
ut 1 1 1 1 ia» aanu. 



All RATI cards found in slots O through 7 on tha Appla ara displayad along 
Ml til lha aaount oi aamor y aach contains. Appla //a and Appla //c hava an 
internal 16K oi mmmur y Mhich appears as slot i althougti fia physical slot O 
actually aMists. Auk i 1 i ar y aaaor y , found on tha Appla //a and built-in on 
tiiv Appla //c, IS not tasted by this utility at this time. An upgraded 
HAn ( ar d test utility Mill Include tests for auxiliary maaory for tha 
Apple //a and Apple //c. 

Beneath the SLOT RAH display ara several aanu itea choices. 

'jeleillog 'I' will (lerturm a NAM card raad/Mrita test. 1* aora than una 
slut Luntains a HAM card you ara proinptad for the slot number. Enter a 
slut number Hhich ccHitains a RAH card. then select 'B' or 'E' to indicate 
Mhether a basic or an extensive test should be performed. The basic test 
ruii!> 1?B times <aster than tha a><t>*nsiva tast but it i« not as thorough. 
Af t tfr salactiiig trie type ui tei.t, ^pwc i I y 'S' or 'C tor single tast or 
cuni inuuus tast. Continuous mode should ba selected for detecting 
intermittent errors on the NfM card. 

Mhile the tast is running, a aassaga aiailar to tha follOMing ona is 
displayed on the scretm: 

Tt at 0008 BAM^ 5 PAbE IM> ALT 

This massage shuMS the sequential tast number (if in continuous mode), the 
bank number, and page number currently being tested. nemor y pages froa DO 
through Df have alternate aeaory pages, Mhich, whan selected, display 
"ALT'* after tha page number. 

Trie test I an ric* terminated by pressing tha 'ESC key, sw^penijed hy 
pres*>ifig trie ^pac e bar, and (ontinued by pressing tha 'RITUHN' key. Like 
all LuLksmith functions, the results can ba printod by pressing control /. 

If any errors Mere found, an error massaga stailar to tha following ona is 
III spl ayad. 

• LhRUR MRITINb AA<3A) Al FEBI ON BfWK I 

Ilie massage shUMS the lest sequence number, tha bank number, the address 
a* tha errur, Mhat Ma* Mritten and Mhat Mas read back in parenthesis. If 
any uthar addresses in the bank of memory changed values spontaneously 
(Mhlle other locations of tha bank Mara being MrlttanI, they Mill ba 

lifted al^c), Miiri the pra<ii> " » '" on the error message. 

Tlie extensive le?.t urites eacti of the 2?i6 possible values to each ot the 
locations of the RAn card, and then reads back the same locatitxi to insure 
that the valua Mas indeed stored correctly. It also checks all other 
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location* of t h« RAfI c»rd to mMUm «tir » ttiat no nthrr loratinn« M«r« 

Mod ■ f I •f1 . Thv hasit I »%t t« t ti» am th« »>.ti*o«iv» tv«t. ewtvpt that 

Ittstvad o# all pr>ft«ihlv ,."S6 valu»«. it t wci trmt vjli.^m (*0 ai»d AA). 

If anv »rror« M»r » f ntind , you may Mant to rnnsiilt t h* MAM card manual to 
dvtarain* tti» location o* tri* faulty RAfI ctiipa, or tak* th* RAM card in 
lor •vrvtcing. 

S«l •€ t I ng ' O * f r ofl» t hr RAfI card ••nii m) I 1 all n** v(>" t d dii«p t h» c ont »nt « 
of tha RAM c sr d ^ \ tt¥ at a t I , into main mrmor y , •€) I riat it ran ha 
•aaaiinad. Tha Lnilvmith di<( and miaor y ad it or I'N' tnim tha main manul 
can ba iiaad to adif tha aamnry. I6K at a 1 1 ma I* dumpad to main mamory 
locationm 7000 (o ">F f f am fnllowmi 

7000-7rrF RAM card pagam DO Pf ALT 
^(KK'-^rff PAM I ar il paijam DO Dr 
aooO^fFF RAM card pagam [O fF 
50Oi>-5fFr RAM card pagaa FO-FF 

II ttia RAM card ynti hava aalactad i« larqar than I6K, you Mill ba prumptad 
lor tt<a bank numbar . For a 1 2BK card, banks Iron O to ' ara valid. 

l_r!»«E> R^l-I C:#!»«D F»=tOM MEMCli=»V 

Prasminq 'l ' Mill load tha RAM card Irom main mamory. Ihim function is 
tha rmvrr%9 nl tha *D' <dump) function. IttK at a t 1 ma 1% 1 ciaifad from main 
mamory to tha malactad bank of tha RAM card. 
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SCAN O X OK 



CO} SCAN DISK 



This utility Mill h«lp you to datarain* tahat tracka ara in uaa on a diak 

you ara trying to copy. 



Prassing 'O' irom tha main aanu Mill put you into tha scan disk utility. 
This utility is u&ad to detarmina Mhat tracks on a disk contain valid 
data. You Mill be prompted for tha drive nuaber you Mish to use and than 
for tha starting track, anding track and iyraaant batiiaan tracka. 

The display is a hi-ras gra|>hic display of tha sync bytaa on a diak. Tha 
graphic display of a track runs froa the bottoa to tha top of the screen. 

The first time you run this utility you should do it on a normal DOS 3.3 
dimk. First try tracks O to 22 In Mhole track Increments. Thlm Mill shoM 
you Mfiat a good track Mill noraal 1 y look like. The series of dots you see 
on the screen above each track nuabar ara tha gaps of salf sync bytas 
betHaen each sector. Normally on a 16 sector disk there Mill be 16 or 17 
of these dots. This is because Locksaith alMays reads long enough to read 
the Mhola track into memory and it may hava read mora than tha Mhole 
track. Similiarly a 13 sector disk Mould have 13 or 14 of tha little 
dots. On a 16 sector disk one of tha dots Mill ba a littl« longer than 
the others, that is the self sync group in front of sector zero on that 
track. If you look closely you can saa a dafinita pattern to tha longer 
dots, they Mill either aova up or dOMn as you aova froa track to track on 
the disk. This is dua to tha tiaa it takas to aova tha disk driva head 
froa track to track. 

NoM using the same disk try scanning from track .5 to track 22.5 Mith an 
increment of 1- You Mill see very long lines of Mhite in no particular 
pattern. This means there is no valid data on tha track. If you see soaa 
evidence of sectors (short bursts of ahita), tha read head axpariancad 
"cross-talk* froa adjacent half-tracks perhaps (but not nacassarily) dua 
to a misalignaant in either tha raading drive or tha driva that wrota tha 
di skette. 

If the disk IS using a protection schaaa called spiral tracking you Mill 
see tha long band of white but thara Hill also ba a pattern of black in 
between the tthlte. The black sections will not ba right next to each 
other but will be offset slightly as you move across the tracks. This is 
due to tha time it take* tha disk drive to move from track to track. Tha 
more that you use the scan disk feature the more valuable you Mill find 
it. This is because you will bacoaa aora adapt at interpreting tha 
results it gives you. 
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rtUTOMAT I C BOOT TFt^CEF* 



I n'tir-caclLjicfc. i art -to f^BT 
IA3 BOOT TRACER 

Th« Automatic Boot Tracar is intandad for use by the more experiencad 
Appl* programmar. It is actually a sophisticated debugger which can 
•laulata the operation at the 6S02 in the Apple. Because disk reading is 
sinHilated, it is possible to actually "boot" a disk (whether protected or 
not I under control of this debuogvri and trace the boot code o-f the 
progran. 

Boot tracing, a normally manual and very tedious technique which 15 used 
by the most sophisticated "hackers", can be performed automatically under 
control of the Lockaeith Automatic Boot Tracer. 

To invoke the boot tracer, key 'A' from the main menu. Vou must have a 
RAM card of at least 16K on your system for ABT to work. If you have an 

Apple //e or Apple //c, the "built-in" 16K RAM will work. 

Locksmith ABT Mill prompt you for the slot number of the RAM card. Key in 
a dtgit from O to 7. 

The ABT Mill be installed on the RAM card you choose, and the ABT will be 
entered. 

Note that in this manual, the ABT (automatic boot tracer) is also referred 
to as the debugger and the simulator, since it actually simulates the 
operation of the 6S02, and can be used as a p o werful debugqer. 

The screen Mill clear and a tine of inversm text Mill appear on the top 
line of the display. The ABT is now operating. 

If you press reset at any time, you Mill be placed in the Apple monitor 
and can reboot another disk by entering the slot number fol lowed by 
control-P. Be careful not to reboot a disk Mhich Mill automatically load 
over th* ABT on the RAM card you selected. 

I r«-F C3r-mdi1^ i cart 1_1 rts 

The top line of the screen which appears in inverse text i* a one-line 
status display Mhich appears initially as follows: 

FAA2 CLD A-OO X-OO V"00 P»34 S"FD 

The first 4 characters are the program counter (FA62 in this example). 
The 6502 opcode at the program counter is also displayed (CLD in this 
examplal. Next, the values of the A,X, and V registers are displayed. 
The "P«* value is the processor status register contents, and the "S=" 
value is the stack pointer. 

At this time, press the R key followed by a key from A through X. Notice 
t^**t the information line disappeared and moved to another line of the 
•creen. Vou can put the information line on any line of the screen that 

coovmnient for the aoftware you will be debugging / tracing. If you 
don't tMnt the information linm displayed, you can place it on row V or 2 
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(Mhich are off the scrcmn). 



I cJ 1 ee M<=>cd<a 

The simulator is in "idle" mode at this time. That is, the program to bm 
simulated is not currently running, but iS atoppM at th* addTMa 
displayed by the program counter. 

Press control-C at this time to mnablm thm processing of 6SC02 
instructions. This is nmcmssary if you arm running on an Appla //c qr an 
■nhanced Appla //•. 

prM* the S key to start exectution under control of the simulator. The 
ABT is noM running simulated 6S02 code. The aimulator is now in "running" 
mode. Note the rapidly changing program counter. The "beep" you hear 
from the speaker may sound a bit different than thm Apple "beep" which you 
arm used to, but that is onJV because under control of the simulator it la 
slowed doMO considerably and sounlfB Ib n ar. 

To stop the program being executed, press Ccontrol-Z]. You are now again 
in "idle" mode. Control-Z is the default character used to stop execution 
of the simulated program, but it can be set to a different "stop" key if 
you need to be able to use control-Z with the software you are tracing. 
To change the "stop" key, first stop the program being executed and return 
to "Idle" mode by pressing control-Z. Then press control-X followed by 
any other key, and the other key Mill be used for the "stop" key. 

To reset the "stop" key to control-Z, enter idle mode and press control-X, 
control-Z. 

Enter idle mode. Now press the space bar and watch the information line. 
The space bar is used in idle mode to single-step one instruction. A "+" 
or "-" Mill appear after each conditional branch instruction, depending on 
whether the branch Mill be taken ("♦") or Mill not be taken <"-">. 

While in idle mode, enter control-Y. You are placed in the system 
monitor, and can enter any monitor commands such as "L" <ta disassemble 
6502 code). To re-enter the simulator, press control-Y, RETURN. Before 
placing you in the system monitor, the simulator saved low memory pages 00 
to 07 on its RAM card. After re-entering the simulator, this memory was 
"refreshed", insuring that no memory was inadvertently changed t^iite in 
the system monitor. 



To review the idle mode commands we have already learned: 

Space-bar single steps one instruction. It can also be used to 
"single-cycle" (see below). 

"R" moves the information line to rows A through X. 

"S" starts the simulated program running and enters "running" mode. 

Control-Y enters the system monitor. To re-enter the simulator, press 
control-Y again, followed by the Return key. 

Control-X is used to change the program "stop" key, trtiich stops the 
program and enters idle mode. 
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OUtmr idX« Mod« coMMndsi 



"T" (traca nibrauttn*) SMScutM th« •laulatMl prograa until a J8R or RIB 
instruction is fatchad. 

Control -R c.um«« > "aiaulatad* raaat to occur. Tha prograa countar i« 
fatchad from •FFFC. 

Control-I cauaas a "aiaulatad* IRQ intarrupt. 

Control-F turns off tha ■•laulatad* IRS pandtng flag. 

Gontrol-N cauaas a "aiaulatad" NHI intarrupt. i 

Control -a quits tha aiaulator and raturns to tha systaa aonltor. 

Control-RESET also axits tha simulator. 

"1" is usad to mmt sinflla-cycla mcjda. In slngla-cycla mods, tha spaca bar 
cyclas ona 6502 procaasor cyda at a tlaa. inataad of an antlra 

Instruction stap. 

"O" Is usad to sat Instructlon-stap aoda. It Is valid only whan on an 

instruction boundary (not on a cycia in tha middle of an instruction). 

"B" turns tha "baap" flag on and off. Tha baap is soundad Nhan Idla mods 
ia antarad. 

"C" turns tha "click" flag on and off. Tha click ia aoundad for avary 
kaystroka whan not in "running" aoda. 

Control-C turns tha 65C02 flag on and off. Tha dafault valua -for this 
switch is "off". If &5C02 instructions ara to ba simulatad, this flag 
must ba on. Tha Appla //a (anhancad varsion) and Appla //c both contain 
&5C02 procassors and usa 65C02 inatructions in thair rasidant ROM coda. 
Mota that tha aiaulator itaalf doas not uaa 6SC02 inatructiona. Vou can 
tharafora run 6SC02 instructicxts on a noraal 6902 procaasor. 

"K" will take tha next kay prassad and placa it in tha keyboard character 
register. When instruction stepping through code that reads the keyboard, 
this key alloMS a convenient -my to antar a kaystroka to tha prograa being 
traced, without entering the keystroke in "running" aoda. 

"ESC" is used to enter the simulator control menu. The simulator control 
menu is used to display and change internal simulator control information. 

SI mul A-ticar- Ccart-ki^csl Ml ncdcsw 

Press tha "E8C" kay Mhila in idla aoda. Tha aimulator control aindOM la 
displayed, and tha cursor appears In tha upper left of tha window. 

Use the RETURN key, and tha left and right arrow keys to move the curse»r 
around the aimulator control window. These keys only move the cursor and 
do not change any information in the window. To change data anywhere In 
tha window, slaply position tha curaor over tha value to change and 
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re-enter the desired value. To exit from the simulator control window and 
rmturn to idla mode, press the ESC key again. If you wish to cancel any 
changes made in the simulator control window, you aay press control-C 
instead. 

Lmt's look at the siaulator control window in detail. 

The top line looks vary much like the information line in idle mode, 
except that the program counter appears further to the right and no 
instruction is disassembled on the line. The number on the left of the 
line is used for single-byte reading, single-byte writing, and memory 
editing. Enter an address value followed by 'R' to read, 'M' to writs 
(also specify value to write), and 'E* to adit, using tha aaaory adit 
window. 

To change display modes for the simulated prograa (text, graphics, hi-res, 
low-res, pagel, page2, fullscreen, mixed), key in the address to toggle 
(»C050-»COS7) and enter 'R'. When tracing a program in graphics mode, it 
is useful to put the information line on rows U,V,M, or X, and toggle 
mixed mode graphics. Tha siaulator will display tha information line on 
either text page 1 or 2, whichever is selected by the program being 
si mul ated - 

Enter an address, followed by 'E' to enter the memory edit windaw. 

Mhile in the memory edit window, the memory is displayed in both hex and 
ASCII text. Tha cursor can be moved with the RETURN key and arrow keys. 
To change data, simply key in a new value in the appropriate address. The 
ESC key returns to the simulator control windaw, saving all changes to 
memory. If the changes made in the memo r y edit window are not to ba 
made, enter control-C. 

The second line of the simulator control window contains! 
RU>6S O-I 1=1 2=1 3=S 4-1 5=1 6»D 7-1 

"RU=65" This value (decimal 101), the "register update" value, represents 
the number of instructions that are simulated before the registers and 
program counter are updated on the screen, when in "running" mode. If 
this number is set small (01 for example), the registers will be updated 
after every instruction. This however causes the simulator to run less 
efficiently, because of the overhead involved in updating tha information 
line. 

SX o-t- Sp» ec; i -F i cx ^-t i can s 

The rest of the second line displays the slot numbers and how they are to 
be used. Because the simulator resides on a RAM board (indicated by 'S' 
in the slot display, for "SYSTEM"), it must know about all other RAM 
boards and firmware boards if it is to correctly simulate their operation. 
Initially, the slots will be set to 'I' (invalid). Any reference by the 
simulated program to these invalid slots will cause the simulated program 
to stop and control is passed to idle mode. Valid slot specification 
values are: 

'S' system (simulator) slot 

'I' invalid 
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•D' floppy disk drive 



'A' 


RAM card o-f 16K 


or 32K. 


•B' 


RAN c«r«* of MK 


or MOTS. 


•F' 


Firawara card or 


ROM card< 


•T' 


transparant. 





!♦ tha iH»aci*ication for a slot is "transparent", any comaand* for tha 
davica in that mlot Hill be given without any checking or convarsion by 
the simulator. Transparent mode should not be used -for: 

Any devices such as RAM and ROM cards that bahk select memory into 
the addramm ransa DOOO to FFFF, Mhich is u«ad by the simulator. 

Any davicaa auch mm di»k drivaa which ara tiaing dependant, as tha 
claulator runa auch Blo««ar than the 6302 in native node. 

Any devices which may use DMA (direct memory access) to modify memory 
from addresses »0000 to •07FF, as this memory is u»ed by the 
simulator with a copy of the user's memory actually residing on tha 
simulator's RAM board. 



The third line of the simulator control window starting with "PC" is the 
"PC compare stop" line. Up to four program counter values for "compare 
stop" can be specified. If the simulated program's PC equals one of these 
values, the simulator immediately enters idle mode. In addition, one "PC 
compare stop range" can be specified. To enter program counter stop 
values or a range, change the number (initially "0") to the number of stop 
addresses to be entered and then enter the addresses in the space 
provided. To disable PC compare stop, set the number back to "O". 

The "MR" line of the simulator control window is the "memory read address 
compare stop" line. Like the "PC compare stop" line, up to four addresses 
and one range can be specified. Whenever the simulated program attempts 
to read one of these addresses, either by direct addressing, indirect 
addressing or stack fetch, the simulatCir enters idle mode. 

The "MW" line of the simulator control window is the "memory write address 
compare stop" line. Idle mode is entered whenever the simulated program 
attempts to write to one of the addresses specified here. 

F>r-c3ai^ Am CIcziLjir-l Swaap 

The "PCSW" area of the simulator control window is the "program counter 
swap" control area. Up to four address pairs can be specified here. If 
the simulated program's PC equals the first value of a pair, the PC i s 
immediately set to the second value, and execution continues. This is 
very useful for eliminating slow timing loops, which are unnecessary in 
the siaulator. Initially, 3 pairs of PCSW values are given. They ares 
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FCA8 FCB3 - This nullifies the monitor wait routine. 

BAOO BAIO - This nullifies the DOS 3.3 seek delay routine. 

BD9E BDAB - This nullifies the DOS 3.3 motor-on wait routine. 



F*r-ciar~Am Count &i — Ti^acoe T»t»Xmt 

The bottom eight lines of the simulator control window contain the PC 
trace table. The last 64 values of the program counter are kept here, so 
that when the simulated program is halted, a history of the last 64 
instructions can be examined. 

F>i— cifsr- &m M^X ts 

A program running under control of the simulator halts and the simulator 
enters idle mode whenever ona of tha follOMing conditions i> aett 

The "stop" key is pressed by the user. 

An invalid 6S02 or 6SC02 opcode is encountered. "T??" is displayed 
in tha information line where the opcode is normally displayed. 

A JSR or RTS instruction is fetched while running with the "T* 
(trace) command. 

A read or write to the device select addresses of a Slot marked as 

"I" (invalid) in the slot table. 

A compare stop occurs for PC, MR, or MM, while running. 
An attempt is made to write to the floppy disk. 

An attempt is made to reference certain I/O addresses. Among these 
are SC060 and •C06B for either read or write. 



Note that in the case of a coapara stop for MR or MW or an invalid device 
select reference, that idle mode is entered with tha PC containing tha 
address of the instruction <after> the one that caused the compare stop. 
Look at the last address in the trace table to find tha correct address. 



I rt-fcaaf-i-i^l 0|=t ei— ^-fc. a. csr-i a 1 Ncatices 

A few notes on the internal operation of the boot tracer / simulator / 
debugger : 

Floppy disk reading is simulated by reading in an entire track of nibbles 
and passing them one at a time to the simulated program requesting them. 
Each time the simulated program requests a nibble, the next nibble in the 
buffer is returned. The simulated program never has to wait for a nibble 
by polling the high-order bit of the disk register. Because of this, 
framing bit timing is not preserved. In addition, the track is not 
synchronized to any Other track upon reading. Floppy disk writing ia not 
supported. 
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When mding a floppy disk, the simulator maintains the nibbles of the 
most current track on the simulator's system RAM card. This track image 
is valid until either the slot or drive number is changed or reselected, 
or the read/write head is stepped to a different track. Only if the 
current track image is invalid will the real floppy disk be read again. 
Therefore, if the user performs a "CATALOS" operation while under control 
of the simulator and then changes the diskette and performs another 
"CATALOG" operation, the catalog inforaatlon from the first disk will 
still be displayed because the catalog (located entirely on track *tl> did 
not cause the head to change tracks and invalidate the track buffer. To 
manually invalidate the track buffer, change the slot specification to 'I' 
and back to 'D' while in the simulator control window. 

The simulator has code for "sector assist" built-in. This means that when 
the simulated program requests a nibble fallowed immediately by testing 

for disk register ready and a compare for SD5, the simulator immediately 
finds the next »D5 in the track buffer and returns it to the simulated 
program, instead of requiring the program to ignore each nibble until the 
value SDS is found. 

The paddle I/O addresses (SCO^A-SCO^? and •C06C-SC06F) are correctly 
simulated if the code that accesses the t/0 addresses is similar to the 
monitor routine at AFBIE (PREAD). If the reference is not similar to the 
monitor routine, idle mode will be entered. 
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CEFcTrF^-v diskette: 



tC] CERTIFY DSK 

The di&l- certify function of Locksmith >s invoked by pressing *C' from the 
mam menu. It can be used to check a diskette for physical damage prior 
to use. 

THIS UTILITY OESTROVS DATA ON THE TARGET DISK. 

Enter the output drive number, the starting track, ending track, and track 
increment. Insert the diskette you wish to test, and press the space bar 
in response to the prompt to insert the diskette. 

This function works by writing a specific pattern of nibbles onto every 
trdi-^ you spet if led. It then reads this pattern bact- to verify that it 
can read what was written. If Locksmith is unable to read what it wrote, 
it will flag the track as bad. There can be three different reasons for 
the track being flagged as bad. First it may not have been written 
correctly due to a disk drive malfunction. Second it may not read 
correctly due to a disk drive malfunction. Third and most likely the disk 
media is questionable, especially if several adjacent tracks display 
errors. 

Mheii Locksmith checks the disk it will write a period (.) in the status 
area for every track that checks good. If a track checks bad it will be 
flagged with an asterisk (t). 
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1 ^ SECTOR LIT 1 1_ I T I ES 



Thlm function givas you accaam to aavaral utllltias daalgnad to work with 
noraial 16 «actor (ganarally unprotactadl dtaka. Th«M can ba V€B 3.3, 
PRODOS, CP/n, or any atamlard lA-sactor dlak. 

To invokB any of tha 16-SKtar utllitlM, first praaa 'U' froa tha aaln 
Manu. 

1^, SECTOR DISK VER I F V 
tVl 16 SECTOR FAST DISK VERIFY 

Prasaing 'V from this aubaanu Mill t«l<a you to tha FftST DISK VERIFY 
utility. You Mill ba proaptad ♦or tha driva nuabar of tha disk you mah 
to varKy. Lockaalth Mill than procaad to read tha disk froa track O to 
track •22. 



On tha status display at tha top of tha scraan, a pariod '.' maana tha 
track raad corractly. An <starisk '•' maans tha track did not raad 
corractly. A nunbar raprasants tha nuabar of axtra tinas tha disk had to 
spin to raad all sactors corractly. A nuabar '1* for axaapla aaana tha 
track had to ba raraad onca in ordar to raad corractly. 

BaloH tha statu* display Is tha track/sactor display. On tha track/sactor 
display tha synbols hava tha following maaningi 

A pariod '.' aaana tha sactor was raad corractly on tha firat disk 
ravol ution. 

An Invarsa charactar 'A' mmmnu thara was soaathing wrong with tha addraas 
fiald or tha addrass fiald was alssinfl. 

An invarsa charactar 'D* aaana thara was soaathing wrong with tha data 
fiald. 

A nuabar indicataa that tha sactor was raad corractly, but that it took 
aavaral rmrmmidm to raad it corractly. 



1 ^ SECTOR F^ORMrtT 
tF] 14 SECTOR FORHAT 

Pressing 'F' will alloM you to forest a disk. This utility will foraat a 
disk or a range of tracks with the voluae nuabar you specify. This could 
ba vary uaaful if a track had baan dastroyad accidently. In this case the 
diak would normally ba unusabla. Howavar with this utility you could 
siaply raforaat tha ona track and uaa the diak. 

THIS FUNCTION WILL NOT RECOVER DATA THAT HAS ON THE DE8TROVED TRACK. 

You Mill first be proaptad for the disk drive you Mish to use. Praaa 
althar 'i' or '2', depending on which driva you wl ah to use. Vou will 
than ba pronptad for track atart, and and incramant. Specify tha tracks 
you wish raforaattad. Vou will next ba proaptad for Voluae Nuabar. 
Specify the voluae nuabar that you Mish to foraat in the Address Field. 
FollOHing the Voluae Nuaber, you Mill be asked Mhich Track Nuabers to use. 
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Normally^ the defaults will be used. S3ince it is possible that you may at 
some time wish to use a non-standard format, this is left up to the user. 
For exaaple, some protected dishs currently on the aarket use tracks SOA.S 
through •22.5. These tracks .are foraattad Mith track nuabers %Oh through 
•22. 



1 d> SECTOR D I SK COMRARE 

CCl 16 SECTOR COnPARE 

Pressing a 'C from this submenu will allow you to compare two disks for 
differences. When you select this option you will be asked for the drive 
number of the disk you wish to compare. This routine stares a double-byte 
(16-blt) ihecksum for each sector in memory and compares it to the one 
alre.'^y there. If they don't match you will gat a 'C on the sector 
niiaber display. When reading tha first disk to coapare, it noraal to 
get many 'coapare errors' because incorrect sector checksuas are initially 
in memory. 

After the disk you wish to compare is read into memory, take it out of the 
drive and replace it with the disk you wish to compare to. Press the 
space bar to begin compare, and any sector that matches will have a period 
'.' on the sector display for that sector. If a sector doesn't match 
there will be a letter 'C* on the sector display. The checksums that were 
there from the original disk have now been replaced by those of the disk 
you )u^t compared, so if you pressed the space bar again without removing 
the disk just compared you should yet all periods on the sector 

display. In addition to the '•' and 'C, you may also find inverse 'A' 
and inverse 'D'. These indicate address field and data field errors, 
respect i vely ■ 



X£» SECTOR SVIslG S I GIMATURE 

(SI 16 SECTOR SYNC SIGNATLIRE 

Thi'^ utility IS used to obtain a signature of the sync pattern on a normal 
16 sector dist. This can be useful when working on syncttroni jed disks. 
You will be prompted for the disk drive you wish to use. Enter either 'I* 
or "2'. This routine starts at track »O0 sector SCO. After reading this 
sector, it moves to track i, and displays the first sectur' number that it 
encounters. This continues until all •22 tracks have been checked. 

The sync signature is displayed again and again. It may be slightly 
different due to disk speed varaiations froa tiae to tiae. To terainate 

the sync signature routine, press ESC. 

In addition to checking synchronization, this routine can be used to 
determine what copy prograa created a given 16-sector diskette. 

A sync signature on a 16-sector diskette will normally stiow a progression 
of hex numbers, either ascending or descending. For e:<atnple, the 
following progression stiows he>; numbers descending by ones 

0FEDCBA9a76t,43210FEDCBA9876543210FE 

Me wi 1 1 identify the above progression as (-1), to indicate that each hex 



Lucl smith 6.0 



Page 49 



User's Manual 



d.g.t >s une I es^ than th« one b«*or». Th. follo-.ng tab e ^how.. -^veral 
copy progran... and the progression identifier that identifies t.,e sync 
s?onature for a d.sl «h.ch was created by that spec . f . c copy program 

that .l«plv wr.t.ng data to a d.s^ -.11 not change .ts sync 
-the disk .ust actually be formatted or generated by a copy program that 
fornats the disk. 

ProQrai* signature identifier 

DOS INIT 0DA741EB83... (-3) 

Locksai th 
Foraat 04BC04BC... <*4» 

LockSMith 
Fast Backup OFEDCBATO?. . . <-l ) 

Penulta Copy OECAB. . . <-2> 

CopyWr I t er 

(no verify) OOOOOOO <+0> 

Copywriter 

(verify) 0FEDCBA9e7 . . . (-1) 

Disk Muncher ODBS^FC^iA . . . («») 
Pack Rat 0D85630DAS. . . <»•) 

Note that the signatures will have the same progression throughout the 
signature only if the disk «as recorded in a single i^ass without turning 
the drive off between tracks. For example, the folluw.ng signature was 
generated by Locksmith FAST DISK BACKUP in a single pass copy (with l^BK 
RAM board) > 

0FEDCBA98765432 1 0FEDCBA9a7t5432 1 OFE 

Note that each hex digit is one less than the previous digit. This is in 
agreement with the table shown above. Now compare the following 

SI ynatur e: 

0FEDCBA9873r 1 0FEDCBAt54-S21 0FED78765 

Note that the progression is the same (-1), except that at 3 places 
(Identified by arrows below the signature), where the progression is (-4). 
This is because this signature is from a disk that was created by 
Locksmith FAST DISK BACKUP running without RAM cards. Notice that every 
10 tracks, a break in the progression occurs. This is because without RAM 
cards, FAST DISK BACKUP copies 10 tracks at a lime, and then read^ the 
original disl again. So only groups of 10 tracts remain in sync with each 
other. Incidentally, the break in the progression was (-4). If the disk 
was created by Locksmith FAST DISK BACKUP with verify after write, the 
break in the progression would have been (-3). As you can see, a lot can 
be determined about a disk using sync signature. 
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DOS 3.3 UT X 1_ X -r X E8 



[03 DOSS. 3 UTIL 

PrMsing the 'D' key enters the DOS 3.3 utilities menu. Select any option 
fro* thlm Mnu and you will bm prompted tor th* Input drive to use. The 
input drive Mill also bm used to rmarit* data, if tho function raquiroa. 



CATAl-OG DISK 

pressing 'C from the DOS 3.3 utilities menu will display the catalog of 
the disk in the current drive. Deleted files are marked with a "D" in the 
front of the file name. 



L-OAD DOS FILE I tMTO MEMOFtV 

pressing the 'L' key will allow you to load a DOS file into memory for 
editing with the disk editor. After answering the prompt for the 
filename, the file is read into memory from 42000 to •7EFF. The TSL 
(track / sector list) is placed in memory at •7F00, so that the file can 
be rewritten to disk from the disk editor. 



SMOInl DXSK SF^ACE MAP 

Pressing the 'M' key will display a disk spaca nap on the screen. The 
sectors are displayed down the loft and right sides of the screen. Free 
sectors are Indicated by "-** and used sectors arm indicated by Press 
the apace bar to enter the utilities menu. 



F^IX SECTOR CroUMTS 

Due to errors within DOS 3.3, the sector count of a file in the catalog 
sometimes gets set incorrectly, usually to zero. Pressing 'K' from the 
DOS 3.3 utilities menu will allow you to automatically correct the sector 
counts on the disk. The sectors for each file are counted and compared to 
the information in the catalog. If the counts are not equal, the filename 
and the counts are displayed and you are prompted to press the space bar 
to correct the sector count for the file. Press the space bar to correct 
^he sector count for the file or press the ESC key to abort the function. 



The VTOC (volume table of contents) is a bit-map of the free sectors of 
the disk volume. The catalog is a list of names, each with a chain of one 
or more TSLs (track/sector lists) which define the rest of the sectors in 
the file. If a user's program fails while files are open for output and 
they are not properly closed; the VTOC and catalog can gat out of step. 

Pressing 'V from the DOS 3.3 utilities menu will perform a VTOC/catalog 
integrity verification. The display will appear much like the disk space 

display (function 'H'i and contain both (free sectors) and 

(used sectors). In addition, 3 types of arrars era datactad and 
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di spl ayed : 

Sectors which are allocated m the bit map but not used in any files are 
diaplAyed Mith an inversv "A" (allocated, not used).' 

Sectors which are used in a file but not allocated are displayed with an 
inverse ■U" (used, not allocated). This is a critical situation because 
the file data o< the affected file can be overwritten if another file is 
allocated over it. If this situation occurs, do not use this disk. 
IiDined lately copy the files to a blank disk using the FID utility found on 
the system master diskette. 

Sectors which are allocated to more than one file at a time are displayed 
with an inverse "2" (2 files allocated) or an inverse "3", etc. This 
situation indicates that one of the files overwrote the other one. You 
should copy the files to a blank disk using the FID utility found on the 
system master diskette. 



FVEMOVE: DOS F^FJOM D I SK 

Pressing the 'R' key will allow you to remove the DOS boot code from the 
disk, freeing up 32 more sectors. Notm that only tracks 1 and 2 ilh 
sectors each) are freed. Track O could be freed but DOS is unable to 
allocate files on track zero even if it is narked free. 

A disk space map is displayed. After pressing the space bar, DOS is 
removed from the diskette, the VTOC is rewritten, and a disk space map is 
again displayed. You will notice that tracks 1 and 2 now contain free 
sectors. 



LJIM— DEL-ETE: « f=-II_E 

Pressing the 'U' key from the DOS 3.3 utilities menu will allow you to 
un-delete a file which was previously deleted. Enter the filename when 
prompted. If the filename cannot be found, an error message will be 
displayed. If the file has not been overwritten by another file, it will 

be un-deleted and returned to the catalog. If the file has already been 
overwritten by another file, a message will be displayed and the undelete 
will be aborted. Press the space bar to return to the utilities menu. 



«I_F=»M«BET X ZE C^T^LOG 

Pressing the *A' key will allow you to alphabetize the filenames in the 
catalog. After the names have been read into memory and sorted, you will 
be prompted to press the space bar to allow the alphabetized catalog to be 
written back to the diskette. 



EISICRYPT- « F-II_E 

After pressing the 'E' key (encrypt file), you will be asked to supply the 
name of a file to encrypt. The catalog is checked to verify that the file 
exists. You are then asked to supply a password for the encryption. The 
password you enter will not be displayed on the screen, but you will need 
to enter the password again to verify that you entered it correctly. 
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If both password entries are identical, the file is encrypted using the 
password you supplied. Do not forget the password - it is the only way to 
decrypt this file. If the encrypted file is displayed, it Mill appear as 
meaningless garbage. If the password is forgotten, tha fila Mill probably 
remain that way forever. 



DECRVF^T FILE 

Pressing 'D' from the DOS 3.3 utilities menu will perform a file 
d«»cryption function. This is the opposite of the encryption function 
described above. The procedures are the same as the ones for encryption 
of a file. If you decrypt using the wrong pasMMOrd, th« ,f lie will raaatn 
as meaningless garbage. 

Nate that if a file is encrypted twice (perhaps by two individuals, each 
entering their own password), that the decryption should be done in the 
reverse order. For example, if a file is encrypted first with password 
"LOCK" and then with password "SMITH", the order for proper decryption is 
first with the password "SMITH" and then with "LOCK". 

After data is encrypted, it should be backed up. This is because if an 
attempt is made to decrypt the file with the wrong password, the file is 
scrambled more. To reverse a decryption in error, perform the encryption 
using the same password, arid vice versa. 
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rtDVrtlMCED DISK RECOVER V 



CXI DSK RECOVER 

When you notice a problem with your disk drive which causes disk I/O 
errors, either on a p«rMn«it or intsraittcnt basis, it's bast to have 
your drive checked. 

What i-f you have important data which you've backed up using the 

mis-aligned or faulty drive? 

Locksmith Advanced Disk Recovery (ADR) will recover data which cannot be 
read from a diskette due to one of three problems: track mis-alignment, 
of-f-center hub clampingp and improper disk speed. 

Proper track alignment is more critical than disk speed when reading and 
writing data to a diskette. While disk speed, once set, usually remains 
constant; track alignment, because it is affected by normal mechanical 
wear of the drive mechanism, can change with time. 

While disk drive track alignment should only be attempted by a qualified 

technician, there are some warning signs that indicate improper track 
alignment of your disk drive. Track mis-alignment should be suspected if 
data which was written on a specific disk drive is difficult or impassible 
to read using a different disk drive. This symptom does not indicate 
which drive is mis-aligned, but merely that an incompatibi ty exists 
between the two drives. Sometimes the mis— al ignment problem is compounded 
because the writing and reading disk drives are mis-aligned in the 
opposite direction. For example the writing drive may record a track 1/4 
track too low and the reading drive may attempt to read the track 1/4 
track too high. The resulting difference of 1/2 of a track is enough to 
make the data impossible to read. Even if the reading drive alignment is 
correct, the resulting difference of 1/4 track is enough to make the data 
read unreliably, especially on the inner tracks o^ the diskette (higher 
track numbcN'S) where the data density is greater. 

Mhile track alignment problems usually manifest themselves gradually over 
time, a problem due to off-center hub clamping (more common on older 
drives or diskettes without hub rings) is usually quite sudden and severe. 
When the disk drive door is closed, the hub clamps down on the center hole 
of the diskette. If the media is slightly off-center when the door is 
closed, it 15 usually centered as the hub clamps it into position. 
Sometimes the diskette is clamped off-center. If this is done before 
reading a diskette, the resulting abnormal head-seek noise is usually 
noticed and simply opening and closing the drive door will re-center the 
diskette properly. If, however, the diskette is clamped off-center prior 
to formatting and writing, the diskette will be formatted and written with 
no adverse symptoms. The data on the diskette can even be read and 
verified, however, once the diskette is removed, the data will be 
unreadable because it was written with the diskette off-center. Any 
attempt to read this off-center diskette Mill fail. 

Writing sectors to a diskette on a drive which is running too fast can 
cause the fallowing sector's address field to be over-written. Although 
the data field of the sector is intact, the missing address field will 
cause an I/O error when attempting to read the sector. 

Locksmith Advanced Disk Recovery will recover the tlata from a diskette 
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recorded either off-center, with bad track alignment, or with missing 
sector address fields, and write the data to a blank formatted disk. You 
must previously format the disk upon which you wish to place the recovered 
data. (You may use the Locksmith 16-sector disk foraat utility to do 
this. > 

Specify the source and target drive numbers and the starting and ending 
track numbers (usually 00 to 22) and Locksmith Advanced Disk Recovery will 
read the problem disk on the integral as well as half-tracks and 
quarter-tracks as needed to recover the data sector by sector. If you 
wish to perform a test run to determine if Locksmith ADR can recover the 
data without actually writing the recovered data, specify a target drive 
number of jero. Six tracks are processed at a time. The recovered data 
is written to the target disk, unless zero was specified for the target 
disk drive, in which case no writing of recovered data is performed. 

The track status display area at the top of the screen shows the status of 
writing the data to the target disk. The bottom part of the screen is 
used as the sector status display. The numbers appearing in inverse text 
down the left and right sides of the sector status area are the sector 
numbers for each track. The order of the sectors in the sector status 
area is the same as the sector order on the track (0, 7, E, 6, D, . . . ) . A 
single status character is placed in the sector status area for each 
sector to indicate the status of the sector read: 

A period (.) indicates that the sector was read from the correct track 
with no errors. 

An (inverse A) indicates that the address field for the sector was never 
found. 

An (inverse D) indicates that the address field was found but the data 
field was not read correctly. 

A plus sign (+) indicates that the sector was correctly read from a higher 
track, half-track, or quarter track. 

A minus sign (-) indicates that the sector was correctly read from a lower 
track, half-track, or quarter track. 

A semicolon (;) indicates that the sector was missing an address field, 
but that this problem was corrected. 

Note that only the (inverse-A> or (inverse-D) indicate an unrecovtH^able 
error. 

The following figure shows a sample screen after Advanced Disk Recovery 
has recovered data from an off-center disk: 
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DSK RECOVER 

.00 
.25 

.50 

. 75 

HE X oooooooooooooooo iiuniiimiiii oooo 

TRK 01 2345A7B9ABCDEF01 234567B9ABC0EF0 1 23 
0++ — .♦.-.♦.-+.-.♦.-.+. — ♦. — — +. -O 

7*. — ++ — . +-. +. -++ — . +. — *.-.*. -y 

E+. - .•«•. -. ++-. +. — . + — . + . -.+--.+ — E 
b+. -.*.-.+.-.*-. *.-.*. — . + — . . — . + — ti 
D+ — .+.-.+.-+. - .♦.-.+.-.+. — .. — + . — D 
5. — ++ — ++. -+.-++ — . +. -.+.-.+.-.+. — 5 
C. -.+.-.+♦ — +. — .♦ — . *.-.+ — . -.C 
4. -.♦.-.+.-.+-. +.-.♦. — . + — . + — . + — .4 
BD- + +. - .+.-.+-.+.-.+.-.+. — . + — +. — + B 
3A. ++ — ++. -. . -. + — . +. -. +.-.+.-.+. — +3 
AA. +.-.+♦ — +. -+. — *. — .+.-.+.-. + — . +A 
2A. +.-.+.-.♦.-+. -.■»-. — +. — .+.-. . — .+2 
9. ++.-.+. -.♦-.+.-.+. -. *. — -. +. — . +9 
1 — +♦.-.♦-. ♦ — .+.-. + . -. + .-.+.-.+.1 
8.+.-.+* — *♦-.+-.••■. — .♦.-.♦.-.+ — .+.B 
F. +.-.+. -.+.-+.-.+. — + . — .+--+. — .+-F 

Note that when the sectors are arranged in the same order in which they 
appear on a track, the plus signs and minus signs on a track appear in 
clusters. This indicates which sectors were found on higher track numbers 
(inward toward the center of the disk) and which were found on Ii>wer track 
numbers (outward toward the edge of the disk). 

It IS common, when recovering data from an of-f-center disk, to have some 
sectors on track 00 which could not be recovered, because to recover them 
would require reading below track zero, which is physically impossible. 
This is usually not a problem, since DOS docs not normally use track 00 
for storing user data. 
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DISK SPEED TEST 



tSJ DISK SPEED 

Pressing 'S' from Locksmith's main menu will put you into the disk speed 
utility. Depending on which overlay you have in memory at the time, you 
may be asked to insert your Locksmith disk to load the program. The first 
question will be which drive number. Then you will be asked which of 
three types of speed check you Mich. The first is to calibrate your drive 
to 300 RPn. This is the normal drive speed recommended by the 
manufacturer. 

The second choice is to calibrate your drive to the optimum drive speed. 
This speed is recommended for copying disks, since it runs slightly slower 
than normal. This helps to ensure that an entire track can be written, 
irregardless of the drive speed of the original. 

The third option is to calibrate your drive to the same speed as the drive 
on which the original disk was written. You will be prompted to insert 
your original disk in the drive. This is to allow Locksmith to determine 
the original drive speed. After inserting your Locksmith disk to load an 
overlay, you will then be given three choices for the graph scale. 

Vou should normally choose fine adjust. The other two options are for 
disks that are so far out of adjustment that they can't be seen on the 
fine scale. After you choose the type of graph you wish. Locksmith Hill 
prompt for the number of samples you wish per plot. 

The choices you have on the above menu are used by Locksmith to determine 
how many times to check the speed prior to plotting a point on the hi-res 
screen. Normally you would select one sample per plot. This will check 

the drive speed once for every point it plots on the screen. 

Next you will be asked to insert a blank disk in the drive you selected 
for the speed test. After you press the space bar Locksmith will write 
and read from track zero of the blank disk. Vou must use a blank disk for 
this test since the data on track zero Mill be destroyed. 



EF«ASE DISK 



CEI ERASE DISK 



This function is used to entirely or partially erase a diskette. 

Pressing 'E' from the Locksmith main menu will take you to this utility. 
THIS UTILITY DESTROYS DATA ON THE TARGET DISK. 

You should place the disk you wish to erase in the drive of your choice. 
Locksmith will prompt you for the drive of the target disk, the starting 
track number and the ending track number you wish erased, and the 
increment between tracks. 

After you have specified the above information. Locksmith will prompt you 
o insert the disk to be erased. After pressing the spacebar, Lockseith 
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Mill proceed to erase the sperified tracks on the disk. 



When the program is finished erasing the specified tracks, it will return 
you to the main menu. The status area is not cleared. Every track that 
Has erased will have an 'E' in the status area. 

Some disk protection schemes require that a track never have been used. 
The only way to accomplish this is to use either a new disk or erase the 
track on a dirk nhich has been previously formatted. 



I ISIBF'ETCTOR y UIATSON 



CI] INSPECTOR 



If you have previuosly loaded Inspector /Matson onto your RAM card with the 
main menu 'L' (load RAM card) function, booted with a DOS disk that loads 
the Inspector /Watson onto a ram card or if you have a firmware card with 
these programs on it then pressing 'I' from the main Locksmith menu will 
place you in either the Inspector or Watson. 

The Inspector /Watson program works exactly as documented in the respective 
manuals, with the following exception. When Inspector /Watson is given 
control from Locksmith, the default buffer address will be 44O0O instead 
of tOSOO. This is because COSOO is reserved for Locksmith use. 



I-f you only have the Inspector, control will be passed to the Inspector. 
If you have both the Inspector and Watson then control Mill be passed to 
Watson. All the normal program commands are useable, with the exception 
of the CSC function (see next paragraph). To exit Inspector /Watson press 
'CTRL-C and you will be back in Locksmith. 

If your Inspector/Watson resides on a RAM board in slot 0, the ESC key 
Mill also return you to Locksmith. If your Inspector /Matson is in ROM, 
you must use 'CTRL-C to exit. 

For information regarding the use of Inspector /Watson, please refer to 
their respective user's manuals. 
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LOCKSMITH F=-FtOC3R«MM X MC3 l_ AIM (B LI A IB EI 

Locksmith Programming Language (LPL) is a tool which the Locl-smith user 
can use to specify how Locksmith is to perform certain functions. With 
it, the user can set up a procedure to backup a di f f icul t-to-copy disk, 
automatically search for and change data on a disk, repair damaged data, 
etc. Almost anything that can be done with Locksmith can be done 
automatically by specifying the proper LPL commands. 

LPL commands, or statements, are collected into a file. This file can be 
entered from the keyboard by the user or may be loaded from a 
special-format parameter disk (which is included with your Locksmith 6.0). 

-the: imci—Lide < . i > commaimd 

LPL flies can be saved with their own name on the parameter disk. These 
files can refer to other named LPL files on the parameter disk and can 
include parts of these files or entire named files within them. In this 
way you can use a technique used in another file without repeating the LPL 
statements, simply by referring to the name of the other file. Few- 
example, if a file called "BRODBUND" exists on the parameter disk, and it 
contains LPL statements which you wish to use in the current file, use the 
following statement in your LPL file; 

. I BRODBUND 

The ".I" must appear as the first characters on the line, and be followed 
by a space. All of the statements in the named file "BRODBUND" would be 
included when the file you are entering was expanded by the text editor 
during either a synta>; check or backup operation. You can save your file 
to the parameter disk either before expansion (to save disk space) or 
after expansion. Included files can, in turn, refer to additional 
included files. If you wish to include part of a file, you can specify 
the starting and ending line numbers after the file name. For example: 

.1 TESTFILE,4-1F 

The above example would include only line munbers 4 thrisugh IF from the 
file named "TESTFILE". 

There is no limit to the number of .1 include statements which you can 
use, except that the total number of lines in the file cannot exceed FF 
(decimal 2SS). 

Each line entered into the LPL file is given a line number (the line 
number appears to the left of the line in "inverse" characters). The line 

number is printed in hexadecimal to save space on the display, but the 
line numbers are not important, except when including te;:t from other LPL 
files with the .1 directive. An LPL line can be up to 38 characters long. 
The following is an example of an LPL linei 

FIND D5 AA 96 

The above example is an LPL line which consists of a single LPL statement. 
Vou can enter several statements on a single line by separating them by 
colons <:). For example: 
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SLOT A » IN. DRIVE I I OUT. DRIVE 2 

Th« spacas before and after each colon are not necessary, but are included 
for easier readability. If a statement is too long for the current line, 
it can be continued onto the next line by coding a "-" as the last 
character on thm line. For exMplai 

DEPOSIT (OF) <F4) (OF) <04> (FF) - 
D5 AA 96 AA AA 

You may insert reearks or comments into your file at any time to help 
document what you are doing. An asterisk («) causes the rest of the 
statement to be ignored. Note that the coMnent is a statenent, and that 
any statements fol lowing it on the line are evaluated. For e>:a«ples 

« SET SLOT NUMBER : SLOT 6 
SLOT b I « SET SLOT NUMBER 

Both the above lines are equivalent. Blank lines can be included anywhere 
f or ^ease of readability and are ignored. 

l_F"l_ STATEMENTS 

LPL statements consist of "tokens" which can be thought of as words in a 
sentence. Tol' ens are separated by blanks. The first token used in a 
statement determines the type of the statement. A token lan represent a 
variable name or parameter name, a constant, or a processing routine na«e. 
Statements can be grouped into the folloMing categories: 

comment or blank line 
statement label 
assignment state m e n t 
processi ng 

Any statement may have a statement label preceding it. Statement labels 
are optional and are used for branching within the LPL file with the GOTO 
statement. A statement label begins with the keyword "LABEL", and is 
followed by a name. Label names can be of any length, and are any 
sequence of alphabetic or numeric characters or the period, with the first 
character being alphabetic. The following are examples using valid 
statement labels: 

LABEL READ. TRACK. AGAIN : 

GOTO READ. TRACK. AGAIN 

LABEL A2. ERROR t PRT "UENBTH ERROR" 
GOTO A2. ERROR 

XVF»ES OE CONSXANTS 

Several types of constants arm used within LPL. They are described here, 
with eKompIes of each. 



Single byte constant (hexlt 
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D5 

6 

00 
(FF) 

Single byte constants, when enclosed in parenthesis, indicate self-sync. 



Multiple byte constant (hex): 
(FF) D5 AA 96 

00 10 20 30 40 50 60 70 SO 



Double byte constant (hex): 
1A70 

Double byte constants usually represent addresses or lengths. 



Track value constant Chexlt 

12.5 

1A.75 

11.0 

O. 

Track value constants contain a decimal point. 



Single byte character constant: 

"X" 

' X • 

Note that either single or double quotes can be used. 



Multiple byte character constant: 
"DON'T FORGET TO COVER THE NOTCH." 

If a quote is to appear in the constant, use the other quote to delimit 
the string. 



Multiple byte constants can consist of a mix of hex and ASCII data: 
89 'GRD' 80 



Special constant: 

The represents a "don't care" value, when used in search patterns. 



Fl tag constants: 

YES 

NO 

ON 

OFF 

These constants are equivalent to and FF, but are preferred because of 
their readability. 



T" VR-ES OE I «I3L_ES 

Variable names used within LPL usually have a specific use for each name, 
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although some yeiiet *l - purpo&e namus have been provicled fur the user. 
Several types variable names are provided wjthin LFL. Ttiey are 
described here, with examples for each. 



Single byte variables 

SLOT 

IN.DRIve 
OUT. DRIVE 



Multiple byte pattern/string variable: 

GR. CHARS 

FATl 

SVNC.PAT 

Pattern/String variables are variable length, and have a one byte length 
as the first byte of the variable. Although pattern/string variables have 
a variable length, each is allowed a maxiffium length of 15 (decimal). 



rlL'ltiple byte variable: 
NIF.TRAIJS 
BCr. TRANS 
IMV. TAB 

Tlifse variables refer to mul t l p 1 e-by t e areds of memory of fi.ed length, 
i.i.ch as loolup tables. Becau5.e they are fi>^ed length, there is no length 
l-^te prefi.. as^iociateij with the variable. 

If you have a need to refer to a byte within a multiple byte variable, you 
can code a plus sign followed by the displacement into the table. For 
tf: ampl es 
NICi. TRANS ♦2r 



Ooiihle byte pointer variablei 
ETART 

rrm 

in .i FN 
r 1 IF goR 
f rr.w 
r-TP. X 

F TR. Y 
PTR . Z 

Ptjuble byte pointer variables can also represent lengths. 



Tr dcl var 1 cib 1 ei 
E( TiIN.TRr 
FUD.TRK 
I NCR. TRK 
SYNC. TRK 

Track variables can represent integral track values, or 1/4, \/Z, or T/4 
tracks. 



Flag variablei 

SYNC 

COUNT 
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SHOW- ADDR 

Flag variables are single byte variables that contain a flag of YES/NO, 
ON/OFF, or FF/0 and act as switches which can be set and tested. Values 
other than these may have unpraMtictalil* results. 



-THE «SSI€3MMEIMT ST^T EMEISJT" 



The assignment statement is used to assign a value to a variable. The 
variable can be assigned the value of a constant or another varlabla. 

The variable to be assigned and the variable or constant to which it is 
assigned must be of the same type. For example, a pointer variable can 
only be assigned to another pointer variable or a two-byte value (3 or 4 
hex digits). 

Some examples of valid assignment statements arcs 



START CURSOR 

Set the variable START (start of track data) to CURSOR (current cursor 
location) . 



CURSOR 2040 

Sets the value of CURSOR to point to 2040. 



SLOT 6 

Sets the one-byte variable SLOT to the value 6. 



BEGIN. TRK 12.5 

Sets the track variable BEGIN. TRK to the track value 12. S. 



CUR.TRr SYNC. TRK 

Sets the track variable CUR.TI»C to the track variable SYNC. TRK. 
CaUNT YES 

Sets the flag variable to the flag value YES. 

PAT4 D5 AA 96 
PAT 4 FAT 7 

Both of the above string variable assignments are valid. 
GR. CHARS 89 'GRD' 

Seta the string variable GR. CHARS to the 4-byte string consisting of h*« 
89 (control-I character) followed by the ASCII data '6RD'. 

DF.HDR3 B4 : AF.HDR7 DD 

These assignment statements set the third data field header byte to B4 
<nor.iijny AD) and the third address field header byte to DD (normally 96). 
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AF.TRLt.TEST IGNORE. TRL 
AF.TRL2.TEST IGNORE. TRL 
DF. TRL 1. TEST IGNORE. TRL 
DF.TRL2.TEST IGNORE. TRL 

These assignment statements patch RWTS to ignore the trailer nibbles of 
the address field and data field. 



AF.TRLl.TEST NORM. TRL I 
AF.TRL2.TEST NQRM.TRL2 
DF. TRL 1. TEST NORM. TRL 1 
DF.TRL2.TEST NQRM.TRL2 

These statements patch RUTS back to normal trailer nibble checking. 



AF.CSUM.TEST IGNHRE.CSUM |j » 1^ . 

DF.CSUM.TEST IGNORE. CSUM 
AF.CSUM.TEST NQRM.AF.CSUM 
DF.CSUM.TEST NORM.DF.CSUM 

These are used to patch RWTS to ignore or to use the address field and 

data field checl sums. 

AF.CSUM.ECED 00 
DF.CSUM.CEED 00 

These statements set the checksum seed values for RWTS read address field 
and read data field. 



AF.HDRl D5 
AF.HDR2 AA 
AF.HDR3 96 

AF.TRLl DE 

AF.TRLT AA 
[ir . HPR 1 D5 
Df.HDFr AA 

DF.HDF3 AD ■ 
DF.TRLl DE 
DF.TRL2 AA 

These statements set the default header and trailer values for address 
fields and data fields which are used for reading. 



DF.HDRl.WRT D5 
DF.HDR2.WRT AA 
DF.HDR3.WRT AD 
DF.TRLl.WRT DE 

DF.TRL2.WRT AA 

DF. CSUM. SEED. WRT 00 

These statements set the header and trailer nibbles to be used when 
writing a data field. The last statement sets the seed to be used for the 
calculation of the checksum for writing the data field. 
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LPL processing routines (referred to as "algorithms" in earlier versions 
of Locksmith) are routines that the user can invohe on demand using LPL. 
Some of the routines are comple:: and are driven by many variables, while 
others are simple and operate using only one or two variables. Some 
routines use parameters consisting of constants or pointers passed to them 
and some accept no parameters at all. The valid syntax of each processing 
routine 15 described in an addendum to this manual, but we will describe 
some of the processing rOLitines here and give some eitamples of their use. 
The Parameter Diskette included with your Loci smith is an e:;cellent source 
of examples for the use of LPL processing routines and variable names. 
Vou may also wish to refer to a "Quick Reference of LPL Names" in the 
addendum to this manual for a complete list of all variable names and 
processing routine names. 



ABORT "DATA NOT FOUND" 

Aborts the current operation and displays the message on the screen, then 
returns to the main Locksmith menu. 

PAUSE "ENTER 1,2, OR 3:" 

After a key is pressed, the value of the key is placed in the single-byte 
variable KEY. IN 

PRT "DISC MUST BE WRITE/ENABLED" 

F'rints the message on the screen. If the last character of the message is 
a blank, the cursor remains on the same line for additional output. 

SHOW SLOT 

Prints the value of the variable name SLOT. If the flag variable 
SHOM.ADDR is YES or ON, the address of the variable SLOT is also printed. 

GOTO READ. AGAIN 

Branches to the label READ. AGAIN elsewhere in the LPL program. 
FIND D5 AA 96 

Causes a search from the current CURSOR pointer until the END pointer, 
searching for the string 05 AA 96. 

FIND PAT4 

This is the same as the previous eNampIe, except that the search is for 
the contents of the string variable PAT4. If a processing routine accepts 
a string variable, it also accepts an explicitly coded string. 

ERROR '5' 

This causes the character 'S* to be placed in the current track of the 
status display area. 

PAT4 D4 DD FF 
PATS 05 AA 96 
CHANGE PAT 4 PATS 

This processing routine changes all occurrences of the first string to the 
second for the entire range of START to END. Note that the CHANGE 
^^■^^ement and other statements that accept two strings as parameters do 
not accept multiple byte constants. For example, the following use of the 
CHANGE statement is invalids 
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CH«NGE D5 96 PAT4 

CHANGC PAT4 D5 AA 9i 
CHANGE D5 AA B4 TO D5 AA 96 



COPY 22 1 (invokes track procedure) 
FCOPY 22 (Fast Disk Backup copy) 

ERASE 

This causes the track to be erased on the output drive. 

FORWARD TRK.LEN 
BACK TRK.LEN 

These statements cause the CURSOR to be moved forward or bacl-ward by the 
length determined by the variable TRK.LEN. These routines can also be 
coded with a 2-byte constant. For examples 
FORWARD 024E 
BACK O042 

CODE AD CUR.TRK OA OA OA OA 60 

The CODE processing routine is provided -for the 6502 assembly language 
prograniner . The parameters supplied are decoded, placed in a contiguous 
area o^ memory, and given control with a JSR instruction. 



PRT "ASCII TEXT TO PRINT" 

The "PRT" routine prints data on the display screen. If the last byte of 
the string is a blcjnl , no new line is started. In this way, you Can 
display teiit with the value of a variable name. For example: 
PRT "TRACK INCREMENT IS " i SHOM INCR. TRK 



Some processing routines function slightly differently depending on 

whether in "nibble-mode" or in "byte-mode". If the last read or write 
command was NREAD or NWRITE, then nibble-mode is in effect. If the last 
read or write command was SREAD, SWRITE, TREAD or TWRITE, then byte-mode 
is in effect. 

The routines which function differently depending on whethjer in nibble 
mode or byte mode are FIND, VER, and CHAN6E. 

In nibble mode, a zero value in the pattern specified acts as a "don't 
care" value. It can be coded as either "7" or "O". 

In byte mode (used when reading or writing sectors), the zero value in a 
pattern is significant. 

For example: 

NREAD : FIND D5 00 96 

The abova ■tatements perform a nibble-read of the current track, and place 
the CURSOR on the first occurrence of a DS value, fallowed by any value, 
followed by a 96 value. 

The statements! 



TREAD : FIND D5 00 96 
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The above e!;ample performs a track-read of the current track, and placn 
the CURSOR on the first occurrence of a DS, followed by a OO, followed by 
a 96. 

In byte-mode, "don't care" values in pattern search strings are not 
allowed. 

Th« following processing routinav accept either string variables or 

multiple byte constants: 

FIND 

VER 
REP 

DEPOSIT 

The nibble or byte mode can be changed manually by Mtting the flag 
variable BYTE. MODE to YES if byte mode is desired, or to NO if nibble mode 
is desired. 
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A track procedure is a sequence of LPL statements that are to be executed 
for each track that is being copied. (One may consider the antire LPU 
file as a disk procedure, because it is involved with processing the 
entire dist.. to be copied.) The trad procedure is defined with the 
BECIN.PROC and END.PRQC statements. The track procedure is then later 
invoked for each track to be copied, by a processing routine which invokes 
thi? track procedure. There is currently only one routine which invok'eS 
the current track procedure. The COPY processing routine (either 
nibble-copy or sectoi — copy) invokes the current track procedure. The 
"current" track, procedure is the last one which was defined. If no track 
procedure was defined in the LPL file, then the default Locksmith track 
procedure is used. 

For exanple: 

BEGIN. PI^OC 

. . . track procedure A 

END.PRQC 

COPY 8 2 
COPY 12 18 2 

BEGIN. PF:OC 

... track procedure B 

END.PROC 

COPY 19 2 
COPY 13 19 2 

In the above e::ample, the first two COPY processing routines will use 
trac). procedure A, and the second two COPY routines will use track 
procedure B. 

The LPL statements within the track procedure can be used to process a 
tracl in one of two modes. Either in nibble-mode or sector-mode. 
Nibble-mode processing routines are NREAD, NWRITE, NVERIFY, which process 
a tract in the form of nibbles. Sector-mode processing routines are 
TREAD, TWRITE, TVERIFY, which process a track in the f^m of 16 separate 
sectors. 

The foriiiat of the COPY com«and isi 

COPY :beQin.trk> <end.tr*:> <incr.trk> 

where <begin.trl'> is the starting track, <Bnd.trk> is the ending track, 
and <incr.trk> is the track increment. These values are stored in the 
variable names BEGIN. TRK, END.TRK, and INCR.TRK, respectively. 

If tracks are to be synchronized or nibble-count preservation is to be 
performed, set the variable names SYNC or COUNT to the value YES. The 
SYNC and COUNT keywords are not specified on the COPY command, as in 
version 5.0 of Locksmith. 
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During execution o-f the LPL program, soma errors may be encountered which 
cannot be checked for during syntax check of the LPL statements. 

If an error is encountered during execution of LPL code, processing 
immediately stops and the following message is displayed on the screen: 

LPL CODE ABORTED 

ERHOK CODE XX 

where "xx" is one of the fallowing valuest 

01 GOTO statement encountered without finding the matching LABEL 
statement . 

02 FROC. BEGIN statement encountered while already within a track 

procedure. 

03 PROC.END statement encountered while already outside of a track 
procedure. 

04 COPY statement encountered within a track procedure. The COPY 
statement invokes a track procedure and cannot occur within one. 

05 USE. DEFAULT. PROC encountered while within a traeifc procedure. 
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SeCTOR NUMBER DECODE TrtBL-E 



N X BBL-E DECODE TABL-E 



OOi AA 


AA 


20 1 


BA 


AA 


40 1 


AA 


EA 






80 1 EA 


AA 


AOs 


FA 


AA 


COsEA 


EA 


EOlFA 


EA 


OllAA 


AB 


21 1 


BA 


AB 


41 1 


AA 


EB 


Oil DH 


cm 


Bis EA 


AB 


All 


FA 


AB 


CltEA 


EB 


Ell FA 


EB 


02iAB 


AA 
AB 


22 1 


BB 


AA 


42i 


AB 


EA 


62t BB 


CA 


a*?* en 

D^X CD 


AA 


A2i 


FB 


AA 


C2iEB 


EA 


E2iFB 


EA 


03|AB 


23 1 


BB 


AB 


43i 


AB 


EB 


63 1 BB 




83 1 EB 


AB 


A3i 


FB 


AB 


C3sEB 


EB 


E3iFB 


EB 


04l AA 


AE 


Z4i 


BA 


AE 


44i 


AA 


EE 


64 1 BA 


EE 


B4 : EA 


AF 


A4 1 


FA 


AE 


C4i EA 


EE 


E4i FA 


EE 


OSiAA 


AF 


2Si 


BA 


AF 


45i 


AA 


EF 


63 1 BA 


EF 


85 1 EA 


AF 


AS 1 


FA 


AF 


C3: EA 


EF 


ESi FA 


EF 


061 AB 


AE 


26: 


BB 


AE 


46 1 


AB 


EE 


66 1 BB 


EE 


aj^ • cn 


AE 


A6 1 


FB 


AE 


C6t EB 


EE 


E61FB 


EE 


07i AB 


AF 


27 1 


BB 


AF 


47 1 


AB 


EF 


67i BB 


EF 


87 1 EB 


AC 


A7 ; 


FB 


AF 


C7i EB 




E7i FB 


EF 


OeiAE 


AA 


281 


BE 


AA 


48 a 


AE 


EA 


68i BE 


EA 


ao* cc 

BBS EE. 


AA 


AOi 


FE 


AA 


C8s EE 


EA 


EBi FE 


EA 


09 1 AE 


AB 


29i 


BE 


AB 


49 1 


^ 


EB 


69t BE 


C0 




AB 


A9 


FE 


AB 


C9sEE 


EB 


E9:FE 


EB 


OA:AF 


AA 


2Ai 


BF 


AA 


4Ai 


AF 


EA 


6Ai BF 


EA 


OA* CC 


AA 


AA) 




AA 


CAi EF 


EA 


EA: FF 


EA 


OBi AF 


AB 


2Bi 


BF 


AB 


4Bi 


AF 


EB 


6B: BF 


EB 


BB : EF 


AB 


AB 


PP 


AB 


CBt EF 


EB 


EB: FF 


EB 


OCl AE 


AE 


2Ci 


BE 


AE 


4C: 


AE 


EE 


6Ci BE 


EE 


BC 1 EE 


AC 


AC 


FE 


AE 


CCi EE 


EE 


EC: FE 


EE 


OD! AE 


AF 


2D 


BE 


AF 


4D 


AE 


EF 


6Di BE 


EF 


BDi EE 


AF 


AD 


FE 


AF 


CDs EE 


EF 


EDiFE 


EF 


OEl AF 


AE 


2Ei 


BF 


AE 


4Ei 


AF 


EE 


6Ei BF 


EE 


ac* CC 


AF 


AE 


FF 


AE 


CEsEF 


EE 


EEiFF 


EE 


OFiAF 


AF 


2Fl 


BF 


AF 


4F 


AF 


EF 


6Ft BF 


EF 


ac« CC 
Br s br 


AC 


AF 


FF 


AF 


CFsEF 


EF 


EFi FF 


EF 


lOi AA 


BA 


30 1 


BA 


BA 


SO 


AA 


FA 


70i BA 


FA 


OA « CA 

YUS C.H 


BH 


BO 


FA 


BA 


DOs EA 


FA 


FOt FA 


FA 


lIlAA 


BB 


31 


BA 


BB 


SI 


AA 


FB 


71s BA 


FB 


9 1 1 EA 


nn 

DD 




FA 


BB 


Dl 1 EA 


FB 


Fit FA 


FB 


12! AB 


BA 


32 


BB 


BA 


32 


AB 


FA 


72: BB 


FA 


92i EB 


BA 


B2 


cn 


nA 


D2: EB 


FA 


F2: FB 


FA 


13: AB 


BB 


33 


BB 


BA 


53 


AB 


FB 


73 1 BB 


FB 


93 1 EB 


BB 


B3 


cn 
r B 


nn 

BO 


D3i EB 


FB 


F33FB 


FB 


14: AA 


BE 


34 


BA 


BE 


54 


AA 


FE 


74: BA 


FE 


94 1 EA 


BE 


B4 


FA 


nc 

DC. 


nA* CA 


pg 


F4i FA 


PE 


ISi AA 


BF 


35 


BA 


BF 


55 


AA 


FF 


7SiBA 


FF 


9Si EA 


BF 


BS 


1 f" n 


nc 
Or 


n^* CA 


FF 


FSi FA 


pp 


16iAB 


BE 


36 


IBB 


BE 


96 


lAB 


FE 


76i BB 


FE 


96 1 EB 


BE 


B6 


FB 


nc 

BH 


D6 1 EB 


p^ 


F61 FB 


PE 


17iAB 


BF 


37 


iBB 


BF 


37 


AB 


FF 


77s BB 


FF 


97sEB 


BF 


B7 


iFB 


BF 


D7iEB 


FF 


F7:FB 


FF 


IBi AE 


BA 


38 


1 BE 


BA 


58 


AE 


FA 


78 1 BE 


FA 


98 1 EE 


BA 


68 


FE 


BA 


D6 : EE 


FA 


FB: FE 


FA 


I9:AE 


BB 


39 


■ BE 


BB 


59 


AE 


FB 


79 1 BE 


FB 


99iEE 


BB 


B9 


iFE 


BB 


D9:EE 


FB 


F9iFE 


FB 


lAsAF 


BA 


3A 


!BF 


BA 


SA 


t AF 


FA 


7AiBF 


FA 


9AtEF 


BA 


BA 


iFF 


BA 


DA:EF 


FA 


FA:FF 


FA 


IB: AF 


BB 


3B 


iBF 


BB 


SB 


lAF 


FB 


7BtBF 


FB 


9BlEF 


BB 


BB 


• CC 


DO 


DBsEF 


FB 


FBxFF 


FB 


tCl AE 


BE 


3C 


■ BE 


BE 


sc 


lAE 


FE 


7CxBE 


FE 


9CtEE 


BE 


BC 


iFE 


BE 


DCiEE 


FE 


FCtFE 


FE 


1D:AE 


BF 


3D 


■ BE 


BF 


5D 


lAE 


FF 


7D:BE 


FF 


9DtEE 


BF 


6D 


iFE 


BF 


DDi EE 


pp 


FD: FE 


pp 


lEiAF 


BE 


3E 


iBF 


BE 


SE 


lAF 


FE 


7EiBF 


FE 


9E:EF 


BE 


BE 


IFF 


BE 


DE c EF 


P£ 


FEi FF 


PE 


tFiAF 


BF 


3F 


iBF 


BF 


SF 


1^ 


FF 


7FiBF 


FF 


9FsEF 


BF 


BF 


iFF 


BF 


C^i EF 


pp 


FFiFF 


pp 


XRACK NUMBER 


decode: 


















OO: AA 


AA 


01 : AA 


AB 


02: AB 


AA 


03: AB 


AB 


04i AA 


AE 


05: AA 


AF 


06: AB 


AE 


07l AB 


AF 


OB: AE 


AA 


09: AE 


AB 


OA: AF 


AA 


OBi AF 


AB 


OCl AE 


AE 


ODi AE 


AF 


OEl AF 


AE 


OFiAF 


AF 


10: AA 


BA 


1 1 


: AA 


BB 


12: AB 


BA 


13iAB 


BB 


14i AA 


BE 


ISiAA 


BF 


I61AB 


BE 


17<AB 


Bf 


18: AE 


BA 


19: AE 


BB 


lAlAF 


BA 


IBsAF 


BB 


ICiAE 


BE 


IDiAE 


BF 


lElAF 


BE 


IFiAF 


BF 



20iBA AA 2I1BA AB 22iBB AA 23iBB AB 



NIBBLES VALUE NIBBLES VALUE 



AA 


AA 


00 


AE 


AA 


oa 


AA 


AB 


01 


AE 


AB 


09 


AB 


AA 


02 


AF 


AA 


OA 


AB 


AB 


03 


AF 


AB 


OB 


AA 


AE 


04 


AE 


AE 


OC 


AA 


AF 


05 


AE 


AF 


OD 


AB 


AE 


06 


AF 


AE 


OE 


AB 


AF 


07 


AF 


AF 


OF 
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The following tranalAta labia is usad for calculating data fiald 
checksums. It Im dascribad in tha chaptar on -tha di«fc aditor dascribi 
the '0' coaaand. 



00:96 


01 :97 


02: 9A 


03: 9B 


04: 9D 


05: 9E 


06l9F 


07: A6 


08iA7 


09i AB 


OAiAC 


OB: AD 


OC: AE 


0D:AF 


0EiB2 


0FtB3 


10iB4 


lliBS 


12iB6 


13iB7 


14: B9 


15: BA 


I61BB 


17iBC 


1B:BD 


19iBE 


lAiBF 


IBtCB 


1C:CD 


1D:CE 


1E:CF 


tFtD3 


20: D6 


21 : 07 


22:09 


23iDA 


24: DB 


25: DC 


26: DD 


27: OE 


2B>DF 


29iES 


2AiE6 


2BiE7 


2CtE9 


ZDtEA 


2EiEB 


2FiEC 


30: ED 


31 :EE 


32: EF 


33:F2 


34:F3 


35:F4 


36: F3 


37;F6 


38iF7 


39iF9 


3AsFA 


3B:FB 


SClFC 


3DlFD 


SElFE 


3FlFF 
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Th« ssctor nuiiib»r« contained in th» addrass fialda a 16-»»ctor 
^ormattad dimkatta appear in amcanding ordar <»0 to •F) on successivs 
sectors. These physical sector numbers arm converted by the disk 
operating system to logical sector nunberm, to allOM -for faster read/write 
o-f multiple sector*. The -following table ahows the relationship between 
physical sector nuaibar and logical sector number. 



PHYSICAL LOGICAL 



o 


O 


1 


7 


2 


E 


3 




4 


D 


5 


S 


6 


C 


7 


4 


a 


B 


9 


3 


A 


A 


B 


2 


C 


9 


D 


1 


E 


B 


F 


F 
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There have been tto different track foreats in coaaon use for the Apple 
II. One of thea recorded 13 sectors on each of the 33 tracks. The other, 
by eaploying a aora efficient data packing algorlthe and slightly aodlfiad 
hardMare, is capable of recording 16 sectors per track. 

Both foraats are basically the saae, with the exception of the nethod of 
packing the data field. In addition, the address field header Is slightly 
different to allow the two different forests to be idonttflad easily. 

Since the 13 sector foraat is no longer in coaaon use, we will discuss the 
16 sector foreat, and will identify where the two foreats differ. 

The track is recorded Kith 16 (or 13) sectors, each consisting of an 
address field and a data field. The address field contains information 
about the data field which teee d lately follows it. The fields are 
separated by gaps, which contain 'self -sync' nibbles. These self -sync 
nibbles are specially recorded nibbles which cause the disk controller 
hardware to synchronize, so that the field following the self-sync can be 
read. 

The address and data fields each contain a header, inforaatlon nibbles, 
and a trailer. 

The address field contains header nibbles of 03 AA 96 (or 03 AA B3, If 13 
sector), folloMed by 4 Items of Information, encoded In double-nibble 
foraat. Two consecutive nibbles are used to represent the volume number, 
track number, sector number, and checksua. The checksua Is siaply an 
excluaive-or of the other 3 iteas of inforaatlon. A table is included in 
this manual to allow you to convert these double-nibbles to the values 
they represent. Following these 4 items of Inforeatlan, Is the address 
field trailer, which consists of DC AA. 

Mtmr a gap of self-sync nibbles, the data field appears. The data field 
consists of a header, 03 AA AD, followed by 342 nibbles (or 410, if 13 
"•ctor format) which represent the actual sector data. These nibbles are 
encoded using a 6-bit table shown in the appendix section of this manual 
titled 'Data Field Nibble Encoding*. (If 13 sector format, a S-bit table 
is used.) After the data nibbles, a single nibble is provided for 
checksua, followed laaediately by the data field trailer, DE AA. 

In some early protection scheaes, the header and trailer nibbles In the 
address and data fields were changed to some other value. (see 'History 
of Locksmith and Copy Protection* chapter of this manual) 
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Attention Apple //gs Users: 



The current version of Locksmith 6.0 (revision level D) will work properly 
with any version of Apple // computer, including the Apple //gs. 
However, the Fasi Disk Backup ("F" from main menu) recognizes only 6'IK 
of the 256K (or morel of the //gs memory. If you are going lo be using 
your Locksmith on an Apple //gs, we suggest that you apply a patch which 
is supplied on the included library diskette. 

The patch, which is named "SPATCH FI» IIGS 256". patches your Locksmith 
Fast Disk Backup to £ssi!ai£ that it is running on an Apple //gs. and will 
use 256K of auiiliary memory to perform one-pass backup copies. 

Apply this patch only if you are using your Locksmith on an Apple //gs, as 
after this patch is applied. Fast Disk Backup will not work properly on 
machines other than an Apple //gs. And, of course, you should only patch 
a copy of your Locksmith diskette, keeping the original in a safe place. 

To patch your Locksmith diskette: 

1. Boot your Locksmith disk. 

2. Press T to enter the text editor 

3. Press N' , then "B " (backup/copy disk) 

4 Remove Locksmith disk and insert library disk, then press space bar. 

5. Press down-arrow key (or control-J) until tPATCH FDB IIGS 256" is 
highlighted, then press return. 

6. Remove the library disk and insert the Locksmith disk, (make sure 
that the write-protect tab is removed) 

7. Press the space bar. 

8. Press return key twice. 

9. Press space bar. 

10. Press return key. "PATCH APPLIED SUCCESSFULLY" should appear. 

11. Remove Locksmith diskette, cover the write-protect notch. Tour 
Locksmith disk is now updated. 

12. To use the updated version of Locksmith, you must reboot Locksmith. 

Note that when running Fast Disk Backup, the display incorrectly shows 
that 64fC auimem is being used (28 tracks per pass). Actually, 256K will 
be used (for 35 tracks per pass - one pass copies.) 



Also included oa the library disk are other SPATCH files, including one 
named tPATCH TXT ED DR2 which will set the default Ubrary disk drive 
^''■ive two for users with two drive systems. 



